Skip to main content
POST
/
v1
/
merchant
/
balance
/
transfer
Transfer merchant balance
curl --request POST \
  --url https://api.daya.co/v1/merchant/balance/transfer \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --data '
{
  "amount_usd": "<string>"
}
'
{
  "data": {
    "collection_balance_usd": "400.0000",
    "withdrawal_balance_usd": "600.0000"
  }
}

​
Overview

Transfers USD from the merchant collection balance into the merchant withdrawal balance. This is a USD-only operation.

​
Authentication

​
X-Api-Key
string
required
Your merchant API key
​
X-Idempotency-Key
string
required
Unique idempotency key for request deduplicationExample: 550e8400-e29b-41d4-a716-446655440000

​
Request Body

​
amount_usd
string
required
Amount in USD to transfer from collection to withdrawal balance.Example: 100.00

​
Request Example

curl --request POST \
  --url https://api.daya.co/v1/merchant/balance/transfer \
  --header 'X-Api-Key: YOUR_API_KEY' \
  --header 'X-Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount_usd": "100.00"
  }'

​
Response

​
data
object
required
Updated merchant balance after the transfer.
{
  "data": {
    "collection_balance_usd": "400.0000",
    "withdrawal_balance_usd": "600.0000"
  }
}