Wallet transfers
Move money between two wallets in your ledger. No bank or provider is involved, so it is instant and free of provider fees.
Transfer between wallets
POST/ledger/account/transfer
Debits the sender's wallet and credits the recipient's in one atomic posting. Both wallets must already exist in the currency, and the sender needs enough balance.
| Body | Type | Description |
|---|---|---|
fromOwnerRefrequired | string | The sender. Their wallet in this currency is debited. |
toOwnerRefrequired | string | The recipient. Their wallet in this currency is credited. |
currencyrequired | string | Three-letter currency code. |
amountrequired | number | Major units, greater than 0. 1500.50 is ₦1,500.50. |
reference | string | Your idempotency reference. Generated if omitted, but then you can't safely retry. |
200 OK
{
"message": "Transfer completed",
"status": "OK",
"transactionId": "665f2a0b9a3b4c0012ab3501",
"reference": "order_8841_refund"
}| Status | Meaning |
|---|---|
200 | Transfer completed, or already processed for this reference. |
404 | The sender's or the recipient's wallet doesn't exist. |
422 | Validation error, insufficient balance, or sending to yourself. |
curl -X POST "https://usetreasurywire.com/api/v1/ledger/account/transfer" \
-H "Authorization: Bearer $TREASURYWIRE_KEY" \
-H "Content-Type: application/json" \
-d '{
"fromOwnerRef": "cust_1001",
"toOwnerRef": "cust_1002",
"currency": "NGN",
"amount": 1500.5,
"reference": "order_8841_refund"
}'