curl -X POST 'https://api.yativo.com/api/v1/wallet/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: unique-key-here' \
-d '{ "currency": "COP" }'
{
"status": "success",
"status_code": 201,
"message": "Wallet created successfully",
"data": {
"currency": "COP",
"balance": "0.00",
"created_at": "2026-04-01T10:00:00Z"
}
}
Create Wallet
Create a new currency wallet for your account
POST
/
wallet
/
create
curl -X POST 'https://api.yativo.com/api/v1/wallet/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: unique-key-here' \
-d '{ "currency": "COP" }'
{
"status": "success",
"status_code": 201,
"message": "Wallet created successfully",
"data": {
"currency": "COP",
"balance": "0.00",
"created_at": "2026-04-01T10:00:00Z"
}
}
Create a new wallet to hold a specific currency. Once created, the wallet appears in your balance list with a zero balance.
POST /wallet/create
Requires an
Idempotency-Key header.curl -X POST 'https://api.yativo.com/api/v1/wallet/create' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: unique-key-here' \
-d '{ "currency": "COP" }'
{
"status": "success",
"status_code": 201,
"message": "Wallet created successfully",
"data": {
"currency": "COP",
"balance": "0.00",
"created_at": "2026-04-01T10:00:00Z"
}
}
Authorizations
Your API key (yativo_pk_...) from Developers → API Keys. Send together with X-Api-Secret.
Your API secret (yativo_sk_...), shown once when the key is created.
Headers
A unique string per request to ensure idempotent processing.
Body
application/json
The currency code for the new wallet (e.g. COP, PEN, ARS, CLP).
Example:
"COP"