Skip to main content

Transfer

1 API call in this section.

Transfer Funds​

Billing & Subscriptions / Wallets / Transfer
POST/wallets/transfer?language=en

Transfers funds from the sender wallet resolved from the auth context to a recipient wallet within the same tenant. Currency: - transfer.currency is resolved from Settings (currency.currency_code) using tenant override with system fallback. Authentication: - Requires Bearer Token authentication: Authorization: Bearer {{access_token}} Query Parameters: - language (string, optional): Language code for localized response messages (default: en) Response: - Returns transfer_id, new_balance, amount, currency, timestamp.

Send a bearer token in the Authorization header for an authenticated OnDi user session.
Request
curl
1curl --request POST "$ONDI_BASE_URL/wallets/transfer?language=en" \2  --header "Authorization: Bearer {{access_token}}" \3  --header "Content-Type: application/json" \4  --header "Content-Type: application/json" \5  --data '{6  "amount": 100,7  "recipient_identifier": "recipient@example.com",8  "identifier_type": "email",9  "description": "Transfer funds"10}'
Request body
json
1{2  "amount": 100,3  "recipient_identifier": "recipient@example.com",4  "identifier_type": "email",5  "description": "Transfer funds"6}

Query parameters

languageOptional
query string

en

Language code for response localization (Optional, default: en)

Request body fields

amountExample
number

Example field from the request body.

recipient_identifierExample
string

Example field from the request body.

identifier_typeExample
string

Example field from the request body.

descriptionExample
string

Example field from the request body.

Headers

AuthorizationOptional
header string

Bearer {{access_token}}

Content-TypeOptional
header string

application/json

Responses

Success Response200OK
Error - Invalid Amount400Bad Request
Error - Insufficient Balance400Bad Request
Error - Transfer to Self400Bad Request
Error - Recipient Not Found404Not Found
Error - Recipient Wallet Not Found404Not Found
Error - Unauthorized Access403Forbidden
Error - Unauthorized401Unauthorized