curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/transfers/tx_1745123456_2ea87af00de1' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
"success": true,
"data": {
"type": "funding",
"transfer_id": "tx_1745123456_2ea87af00de1",
"status": "hop1_processing",
"source": {
"chain": "SOL",
"amount": 201.80
},
"destination": {
"currency": "EUR",
"amount": null
},
"tx_hash": null,
"fees": {
"platform_fee": 0.50,
"total_fee": 0.90,
"fee_currency": "USDC"
},
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": null
}
}
{
"success": true,
"data": {
"type": "funding",
"transfer_id": "tx_1745123456_2ea87af00de1",
"status": "completed",
"source": {
"chain": "SOL",
"amount": 201.80
},
"destination": {
"currency": "EUR",
"amount": 200.00
},
"tx_hash": "0x3fbd8b6c6a1e2e6f0a1b8f6a5b4c3d2e1f0a1b8f6a5b4c3d2e1f0a1b8f6a5b4c",
"fees": {
"platform_fee": 0.50,
"total_fee": 0.90,
"fee_currency": "USDC"
},
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": "2026-05-06T14:33:22Z"
}
}
{
"success": true,
"data": {
"type": "withdrawal",
"transfer_id": "cwd_1781020459781_7plaq8",
"status": "settled",
"source": {
"yativo_card_id": "yativo_card_customer_8f9a...",
"amount": 50.00,
"currency": "USD"
},
"destination": {
"address": "0x920abe21a7eb39DF5f5A42AE97F4Cd061d5AdD9b",
"amount": 50.00,
"currency": "USD"
},
"tx_hash": "0xedbca669196b14ddc4b5a8b6fd6c313a1400795cdabe686b3d4b908d8e8279bb",
"failure_reason": null,
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": "2026-05-06T14:33:22Z"
}
}
Card Issuer Program
Get Transfer or Withdrawal Status
Retrieve the current status and details of a single master-wallet → customer-card transfer, or a customer-card → master-wallet withdrawal
GET
/
v1
/
card-issuer
/
transfers
/
:transferId
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/transfers/tx_1745123456_2ea87af00de1' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
"success": true,
"data": {
"type": "funding",
"transfer_id": "tx_1745123456_2ea87af00de1",
"status": "hop1_processing",
"source": {
"chain": "SOL",
"amount": 201.80
},
"destination": {
"currency": "EUR",
"amount": null
},
"tx_hash": null,
"fees": {
"platform_fee": 0.50,
"total_fee": 0.90,
"fee_currency": "USDC"
},
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": null
}
}
{
"success": true,
"data": {
"type": "funding",
"transfer_id": "tx_1745123456_2ea87af00de1",
"status": "completed",
"source": {
"chain": "SOL",
"amount": 201.80
},
"destination": {
"currency": "EUR",
"amount": 200.00
},
"tx_hash": "0x3fbd8b6c6a1e2e6f0a1b8f6a5b4c3d2e1f0a1b8f6a5b4c3d2e1f0a1b8f6a5b4c",
"fees": {
"platform_fee": 0.50,
"total_fee": 0.90,
"fee_currency": "USDC"
},
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": "2026-05-06T14:33:22Z"
}
}
{
"success": true,
"data": {
"type": "withdrawal",
"transfer_id": "cwd_1781020459781_7plaq8",
"status": "settled",
"source": {
"yativo_card_id": "yativo_card_customer_8f9a...",
"amount": 50.00,
"currency": "USD"
},
"destination": {
"address": "0x920abe21a7eb39DF5f5A42AE97F4Cd061d5AdD9b",
"amount": 50.00,
"currency": "USD"
},
"tx_hash": "0xedbca669196b14ddc4b5a8b6fd6c313a1400795cdabe686b3d4b908d8e8279bb",
"failure_reason": null,
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": "2026-05-06T14:33:22Z"
}
}
This single endpoint looks up both directions of fund movement — it checks funding transfers first, then falls back to withdrawals if the ID doesn’t match one. The response’s
Withdrawal (
Poll this endpoint every 10–15 seconds until
type field tells you which one you got back.
string
required
Bearer token:
Bearer YOUR_ACCESS_TOKENstring
required
Either the
transfer_id returned by Fund Customer Card (or the transfer_id on customer.funded/customer.balance.updated webhooks with trigger: "funding"), or the withdrawal_id returned by the withdraw-from-card endpoint (or transfer_id on customer.balance.updated with trigger: "withdraw").curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/transfers/tx_1745123456_2ea87af00de1' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
"success": true,
"data": {
"type": "funding",
"transfer_id": "tx_1745123456_2ea87af00de1",
"status": "hop1_processing",
"source": {
"chain": "SOL",
"amount": 201.80
},
"destination": {
"currency": "EUR",
"amount": null
},
"tx_hash": null,
"fees": {
"platform_fee": 0.50,
"total_fee": 0.90,
"fee_currency": "USDC"
},
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": null
}
}
{
"success": true,
"data": {
"type": "funding",
"transfer_id": "tx_1745123456_2ea87af00de1",
"status": "completed",
"source": {
"chain": "SOL",
"amount": 201.80
},
"destination": {
"currency": "EUR",
"amount": 200.00
},
"tx_hash": "0x3fbd8b6c6a1e2e6f0a1b8f6a5b4c3d2e1f0a1b8f6a5b4c3d2e1f0a1b8f6a5b4c",
"fees": {
"platform_fee": 0.50,
"total_fee": 0.90,
"fee_currency": "USDC"
},
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": "2026-05-06T14:33:22Z"
}
}
{
"success": true,
"data": {
"type": "withdrawal",
"transfer_id": "cwd_1781020459781_7plaq8",
"status": "settled",
"source": {
"yativo_card_id": "yativo_card_customer_8f9a...",
"amount": 50.00,
"currency": "USD"
},
"destination": {
"address": "0x920abe21a7eb39DF5f5A42AE97F4Cd061d5AdD9b",
"amount": 50.00,
"currency": "USD"
},
"tx_hash": "0xedbca669196b14ddc4b5a8b6fd6c313a1400795cdabe686b3d4b908d8e8279bb",
"failure_reason": null,
"customer_id": "6627f3a2c5d4e100123def",
"initiated_at": "2026-05-06T14:30:00Z",
"completed_at": "2026-05-06T14:33:22Z"
}
}
Status reference
Funding (type: "funding")
| Status | Meaning |
|---|---|
pending | Transfer queued, not yet started |
hop1_processing | First transfer leg in progress |
hop1_complete | First leg done, second leg starting |
hop2_processing | Final delivery to customer card wallet in progress |
completed | Funds delivered — customer card is credited |
failed | Transfer failed |
refunded | Funds returned to your master wallet |
type: "withdrawal")
| Status | Meaning |
|---|---|
initiated | Withdrawal submitted, in the card network’s delay-relay queue |
processing | Delay relay executing |
settled | Funds arrived in your master wallet — tx_hash is populated |
failed | Withdrawal failed — see failure_reason |
status reaches a terminal value (completed/failed/refunded for funding, settled/failed for withdrawals). Funding transfers typically complete in 2–5 minutes; withdrawals go through a ~3 minute delay-relay before settling.