Are you looking for test card numbers?

Would you like to contact support?

Marketpay icon

On-demand internal fund transfers

Initiate fund transfers between balance accounts.

In your platform, you can transfer funds within balance accounts on-demand, without fixing a schedule. This page explains how to do this by using the API or your Balance Platform Customer Area.

Before you begin

  • Check the capabilities of the source and destination account holders. You can move funds between the balance accounts of the same account holder but if the balance accounts are not under the same account holder, the account holders must be allowed to use the corresponding capability.
    • sendToBalanceAccount: The account holder that owns the source balance account must be allowed to use this capability.
    • receiveFromBalanceAccount: The account holder that owns the destination balance account must be allowed to use this capability.
  • Ensure that your server can receive and accept webhooks.
  • Contact our Support Team:

Step 1. Initiate a transfer

The following tabs explain two procedures to initiate transfers.

To transfer funds between balance accounts in your platform, ensure that your API credential has the roles to use with the Transfers API. If it does, make a transfer as follows:

  1. Make a POST /transfers request specifying:

    Parameter Required Description
    amount -white_check_mark- Object containing the currency and value of the transfer.
    balanceAccountId -white_check_mark- Unique identifier of the source balance account.
    category -white_check_mark- Set to internal.
    counterparty.balanceAccountId -white_check_mark- Unique identifier of the recipient balance account.
    description Your description for the transfer.
    reference Your unique reference for the transfer.
    referenceForBeneficiary Your reference for the transfer that is sent to the recipient and in all webhooks.

    Here is an example of how you can transfer EUR 100 from your liable balance account to another balance account.

    The response contains a unique id for the transfer request.

Step 2: Get updates on the status of the transfer

Track the transfer request through webhooks that Adyen sends to your server. The webhooks provide the status of the request. The webhooks will also inform you if the transfer failed.

You can also view the transfer in your Balance Platform Customer Area.