English
API ReferenceSign In

Transfer between accounts

Last updated 05/06/2021

image

With xenPlatform, you can flexibly control the balance of your Partners using Transfer. You can transfer any amount of funds from your platform to your partners and vice versa.

Transfer between accounts feature is available in Indonesia 🇲🇨 and Philippines 🇵🇭

Use cases and types of transfers

Transfer TypeUse Cases
image- Send bonuses
- Send refunds
- Top up partner’s balance
image- Charge platform commission
- Charge subscription fees
- Charge management fees
image- Facilitate reselling / dropshipping
- Help manage Partner’s payment operations

For example, if you are a retailer or multi-branch business, you can use this feature to top-up your partners’ balance, send out payouts or bonuses, and charge an administrative fee. Additionally, you can also create transfers from one branch to another branch as well.

Creating Transfers

You can create transfers in two ways:

1. Create Transfer via Dashboard

  1. Navigate to the xenPlatform Accounts page

  2. Click the Create transfer button

  3. Fill in the required fields

    • From: account ID or name where the funds are transferred from
    • To: account ID or name where the funds are transferred to
    • Amounts to transfer: the amount of funds of your choice
    • Reference: a unique identifier of the transfer

image

2. Create Transfer via API

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

  • reference: a unique identifier of this transfer
  • 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":"Subscription fee for Nov 2020","amount":10000,"source_user_id":"5cafeb170a2b18519b1b8768","destination_user_id":"5f8d0c0603ffe06b7d4d9fcf"}'

Note:

  • 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
  • Creating Transfer via Dashboard is currently only available in LIVE mode

Learn more in our API reference