No momento, esta página não está disponível em português
Fast-payout icon

Initiate on-demand internal funds transfers

Send funds or initiate an internal direct debit between balance accounts.

On-demand fund transfers provide the flexibility to move money between balance accounts without a fixed schedule. Use the POST /transfers or your Customer Area to initiate these transfers instantly, either as a standalone solution or to complement your scheduled fund transfers.

Requirements

Before you begin, take into account the following requirements and preparations:

Requirement Description

Integration type

You need an Adyen for Platforms integration.

API credentials

Your API credential for the Transfers API must have the following role:
  • TransferService Webservice Initiate role

Customer Area roles

You need the following roles:
  • Initiate internal transfers

  • Balance platform base role

Webhooks

  1. Make sure that your server receives and accepts webhooks.

  2. In your Customer Area, subscribe to Transfer webhooks.

Capabilities

If the balance accounts involved in the transfer do not belong to the same account holder, check the capabilities of the account holders:
  • The account holder of the balance account that sends the the transfer request must have the sendToBalanceAccount capability.

  • The account holder of the balance account that receives the transfer request must have the receiveFromBalanceAccount capability.

Setup steps

Before you begin your integration, contact our Support Team to enable transfers for the source balance account.

Initiate an internal transfer

To send on-demand payouts, use your Customer Area or make an POST /transfers request. The following tabs explain both methods.

Get updates on the status of the transfer

For every internal transfer request, Adyen sends multiple webhooks to your server: a series of webhooks for the balance account where the transfer is an outgoing request, and a series of webhooks for the balance account where the transfer is an incoming request.

Using these webhooks, you can track the status of the transfer: received, then authorised, and finally booked. The webhooks also inform you if the transfer failed.

You can also view the transfer details in your Customer Area. Each transfer of funds between balance accounts appears in the Customer Area as two transfer entries: one for the balance account that is credited, and one for the balance account that is debited.

See also