Welcome to Xendit’s latest documentation. For legacy content, access the previous version here.

Transfer Balances

Prev Next

With xenPlatform, you have full control over your merchant’s balance. You can transfer any amount of funds from your platform account and sub-accounts, and vice-versa.

Source

Destination

Use Cases

Master-Account

Sub-Account

  • Send bonuses

  • Send refunds

  • Top up merchant’s balance

Sub-Account

Master-Account

  • Charge platform commission

  • Charge subscription fees

  • Charge management fees

Sub-Account

Sub-Account

  • Facilitate reselling or drop shipping

Creating Transfers

Create a Transfer via Dashboard

  1. Navigate to the xenPlatform Accounts page

  2. Click the Create transfer button

  3. Fill in the required fields

    1. From: account ID or name where the funds are transferred from

    2. To: account ID or name where the funds are transferred to

    3. Amounts to transfer: the amount of funds of your choice

    4. Reference: a unique identifier of the transfer

Create a Transfer via API

To create transfer via API, you will need to specify the required parameters:

  • reference: a unique identifier of this transfer for reconciliation purposes

  • amount: the amount you would like to transfer

  • source_user_id: the account balance from which you would like to send the Transfer from

  • destination_user_id: the account balance from which you would like to send the Transfer to

curl --request POST \
  --url POST https://api.xendit.co/transfers \
  --data '{
"reference":"2020-nov-subscription-fee",
"amount":10000,
"source_user_id":"5cafeb170a2b18519b1b8768",
"destination_user_id":"5f8d0c0603ffe06b7d4d9fcf"
}'

Notes on transfers:

  • All transfers will be executed immediately

  • Transfer amount should be less than the total balance of the sender’s account

  • Transfer amount needs to be an absolute number

  • You can only create transfers using the Master-Account's API key. Sub-Accounts that you manage through xenPlatform have no ability to create transfers through this endpoint.