curl 'https://api.yativo.com/api/v1/wallet/deposits/b3150e03-d27e-4de3-a0ff-16ebeb55683c' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
const res = await fetch(`https://api.yativo.com/api/v1/wallet/deposits/${depositId}`, {
headers: { 'X-Api-Key': process.env.YATIVO_API_KEY, 'X-Api-Secret': process.env.YATIVO_API_SECRET },
});
const { data } = await res.json();
if (data.status === 'success') {
// fulfil the order
}
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"id": "b3150e03-d27e-4de3-a0ff-16ebeb55683c",
"deposit_id": null,
"gateway": "22",
"currency": "CLP",
"deposit_currency": "USD",
"amount": 10000,
"receive_amount": 9.36,
"status": "success",
"customer_id": "948a039f-9883-4b1c-88a6-2f1d3c4b5a69",
"transaction_id": "TXN-00123456",
"created_at": "2026-10-22T15:52:43.000000Z",
"updated_at": "2026-10-22T15:58:10.000000Z",
"deposit_gateway": {
"id": 22,
"method_name": "Bank Transfer",
"country": "CHL",
"currency": "CLP"
}
}
}{
"status": "failed",
"status_code": 404,
"message": "Request failed.",
"data": {
"error": "Deposit not found"
}
}Deposits
Get Deposit
Retrieve one deposit and confirm its status
GET
/
wallet
/
deposits
/
{depositId}
curl 'https://api.yativo.com/api/v1/wallet/deposits/b3150e03-d27e-4de3-a0ff-16ebeb55683c' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
const res = await fetch(`https://api.yativo.com/api/v1/wallet/deposits/${depositId}`, {
headers: { 'X-Api-Key': process.env.YATIVO_API_KEY, 'X-Api-Secret': process.env.YATIVO_API_SECRET },
});
const { data } = await res.json();
if (data.status === 'success') {
// fulfil the order
}
{
"status": "success",
"status_code": 200,
"message": "Request successful",
"data": {
"id": "b3150e03-d27e-4de3-a0ff-16ebeb55683c",
"deposit_id": null,
"gateway": "22",
"currency": "CLP",
"deposit_currency": "USD",
"amount": 10000,
"receive_amount": 9.36,
"status": "success",
"customer_id": "948a039f-9883-4b1c-88a6-2f1d3c4b5a69",
"transaction_id": "TXN-00123456",
"created_at": "2026-10-22T15:52:43.000000Z",
"updated_at": "2026-10-22T15:58:10.000000Z",
"deposit_gateway": {
"id": 22,
"method_name": "Bank Transfer",
"country": "CHL",
"currency": "CLP"
}
}
}{
"status": "failed",
"status_code": 404,
"message": "Request failed.",
"data": {
"error": "Deposit not found"
}
}Returns one of your deposits. Pass the deposit’s
Use it to confirm a deposit before you fulfil an order. Check
id or its deposit_id reference.
GET https://api.yativo.com/api/v1/wallet/deposits/{depositId}
status after a deposit.updated webhook, or when the payer returns to your return_url. The query string on return_url isn’t proof of payment.
curl 'https://api.yativo.com/api/v1/wallet/deposits/b3150e03-d27e-4de3-a0ff-16ebeb55683c' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Api-Secret: YOUR_API_SECRET'
const res = await fetch(`https://api.yativo.com/api/v1/wallet/deposits/${depositId}`, {
headers: { 'X-Api-Key': process.env.YATIVO_API_KEY, 'X-Api-Secret': process.env.YATIVO_API_SECRET },
});
const { data } = await res.json();
if (data.status === 'success') {
// fulfil the order
}
404 Deposit not found means the ID isn’t one of your deposits.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.
Path Parameters
The deposit's id (deposit_data.id from Create Deposit, payload.id in deposit.* webhooks) or its deposit_id reference.