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.
Requirements
Before you begin, take into account the following requirements and preparations.
| Requirement | Description |
|---|---|
| Integration type | An Adyen payout service integration and our Checkout API for tokenization. |
| API credentials | Your API credential for balance platform (ws[_123456]@BalancePlatform.[YourBalancePlatform]) has the following roles to use with the Transfers API.
|
| Webhooks | Make sure that:
|
| Limitations | We recommend that you verify if the card is eligible for payouts. If you are not fully PCI compliant or want to make recurring payouts, you must have tokenized and saved the card details. |
| Setup steps | Before you begin, contact your Adyen representative to enable the feature on your account. |
1. 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.
2. 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.
3. Test the payout flow
To test the payout flow with raw card details, make a POST /transfers request using our Visa test card and Mastercard test card details for the counterparty.card.cardIdentification fields.