{"title":"Initiate on-demand internal funds transfers","category":"default","creationDate":1571779920,"content":"

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

Requirements<\/h2>\n

Before you begin, take into account the following requirements and preparations:<\/p>\n\n \n \n \n <\/colgroup>\n \n \n \n \n \n \n \n \n \n
Requirement<\/th>\n Description<\/th>\n <\/tr>\n <\/thead>\n
\n

Integration type<\/strong><\/p>\n<\/td>\n

\n

You need an Adyen for Platforms<\/a> integration.<\/p>\n<\/td>\n <\/tr>\n

\n

API credentials<\/a><\/strong><\/p>\n<\/td>\n

\n Your API credential for the Transfers API<\/a> must have the following role<\/a>:
\n
    \n
  • \n

    TransferService Webservice Initiate role<\/strong><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

\n

Customer Area roles<\/a><\/strong><\/p>\n<\/td>\n

You need the following roles:
\n
    \n
  • \n

    Initiate internal transfers<\/strong><\/p>\n<\/li>\n

  • \n

    Balance platform base role<\/strong><\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

\n

Webhooks<\/a><\/strong><\/p>\n<\/td>\n

\n
    \n
  1. \n

    Make sure that your server receives and accepts webhooks.<\/p>\n<\/li>\n

  2. \n

    In your Customer Area, subscribe to Transfer webhooks<\/a>.<\/p>\n<\/li>\n <\/ol>\n <\/td>\n <\/tr>\n

\n

Capabilities<\/strong><\/p>\n<\/td>\n

\n If the balance accounts involved in the transfer do not belong to the same account holder<\/em>, check the capabilities of the account holders:\n
    \n
  • \n

    The account holder of the balance account that sends the the transfer request must have the sendToBalanceAccount<\/strong> capability.<\/p>\n<\/li>\n

  • \n

    The account holder of the balance account that receives the transfer request must have the receiveFromBalanceAccount<\/strong> capability.<\/p>\n<\/li>\n <\/ul>\n <\/td>\n <\/tr>\n

\n

Setup steps<\/strong><\/p>\n<\/td>\n

\n

Before you begin your integration, contact our Support Team<\/a> to enable transfers for the source balance account.<\/p>\n<\/td>\n <\/tr>\n <\/tbody>\n<\/table>\n

Initiate an internal transfer<\/h2>\n

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

\n
\n \n <\/tabs>\n <\/div>\n<\/div>\n\n

Get updates on the status of the transfer<\/h2>\n

For every internal transfer request, Adyen sends multiple webhooks<\/a> 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.<\/p>\n

Using these webhooks, you can track the status of the transfer: received<\/strong>, then authorised<\/strong>, and finally booked<\/strong>. The webhooks also inform you if the transfer failed.<\/p>\n

You can also view the transfer details in your Customer Area<\/a>. 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.<\/p>\n

See also<\/h2>\n