This page explains how to make a payout request to transfer funds to Mastercard or Visa cards. In the following sections, you can see examples for one-off or recurring payouts.
After you make the payout request, you can track the status of the transfer by using webhooks.
Before you begin
Ensure that:
- You reached out to your Adyen contact to enable the feature on your account.
- The card is eligible for payouts (recommended).
- If you are not fully PCI compliant or want to make recurring payouts, you tokenized and saved the card details.
- Your API credential for balance platform (ws[_123456]@BalancePlatform.[YourBalancePlatform]) has the following roles to use with the Transfers API.
- Bank Transfer Initiation Webservice role
- TransferService Webservice Initiate role
- Your server receives and accepts webhooks.
- You subscribed to Transfer webhooks and Transaction webhooks in your Balance Platform Customer Area.
Initiate a payout
The following tabs show how to make one-off and recurring payments. If you are fully PCI compliant, you are allowed to make payout requests using raw card details. Otherwise, you must use tokenized card details in your request.
The following tabs show examples of the responses that you receive after a successful request.
Get updates on the status of the transfer
Track the transfer request by using the webhooks that Adyen sends to your server. You receive a webhook each time that the status of the request changes. For example, you receive webhooks when Adyen receives the request, when the transfer is authorised, and when the funds are booked and deducted from the balance account.
You can also view the transfer details in your Customer Area.