Create Transfer

curl --request POST \
  --url https://api.cadanapay.com/v1/platform/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceTenantKey": "blm123456",
  "destinationTenantKey": "blm998877",
  "amount": {
    "amount": 500000,
    "currency": "USD"
  },
  "reference": "transfer-123"
}
'

{
  "id": "9b2c1f47-8a0d-4e21-bf3c-2d6f1a9e74c5"
}

Platform

Create Transfer

Move money between your own business accounts — your main business and its child businesses — internally and same-currency only. Settles immediately with no fee.

Set sourceTenantKey to the business funds move from (omit it to send from your main business) and destinationTenantKey to the business they move to. Allowed movements are main → child, child → child, and child → main.

There is no GET for a transfer — track it via the platform disbursements endpoint filtered to type=TRANSFER, matching the returned id or your reference.

POST

platform

transfers

Create Transfer

curl --request POST \
  --url https://api.cadanapay.com/v1/platform/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "sourceTenantKey": "blm123456",
  "destinationTenantKey": "blm998877",
  "amount": {
    "amount": 500000,
    "currency": "USD"
  },
  "reference": "transfer-123"
}
'

{
  "id": "9b2c1f47-8a0d-4e21-bf3c-2d6f1a9e74c5"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

destinationTenantKey

string

required

The business funds move to — a child business or your main business. Cannot equal the source.

Example:

"blm998877"

amount

object

required

Show child attributes

reference

string

required

Your client reference for the transfer. Stored on it so you can locate it later.

Example:

"transfer-123"

sourceTenantKey

string

The business funds move from. Omit to send from your main business, or pass a child business's tenant key.

Example:

"blm123456"

Response

Transfer created response

string<uuid>

The transfer id. Track it via the platform disbursements endpoint filtered to type=TRANSFER.

Example:

"9b2c1f47-8a0d-4e21-bf3c-2d6f1a9e74c5"

Get Disbursement

Custom Roles

⌘I