{"title":"Make a payout to a third-party card","category":"default","creationDate":1675944360,"content":"

This page explains how to make a payout request<\/a> to transfer funds to Mastercard or Visa cards. In the following sections, you can see examples for one-off or recurring payouts.<\/p>\n

After you make the payout request, you can track the status of the transfer<\/a> by using webhooks.<\/p>\n

Requirements<\/h2>\n

Before you begin, take into account the following requirements and preparations.<\/p>\n\n\n\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nAn Adyen payout service integration<\/a> and our Checkout API<\/a> for tokenization.<\/td>\n<\/tr>\n
API credentials<\/a><\/strong><\/td>\nYour API credential<\/a> for balance platform (ws[_123456]@BalancePlatform.[YourBalancePlatform]<\/strong><\/span>) has the following roles<\/a> to use with the Transfers API<\/a>.
  • Bank Transfer Initiation Webservice role<\/strong><\/li>
  • TransferService Webservice Initiate role<\/strong><\/li><\/ul><\/td>\n<\/tr>\n
Webhooks<\/a><\/strong><\/td>\nMake sure that:
Limitations<\/strong><\/td>\nWe recommend that you verify if the card is eligible for payouts<\/a>. If you are not fully PCI compliant or want to make recurring payouts, you must have tokenized and saved the card details<\/a>.<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\nBefore you begin, contact your Adyen representative to enable the feature on your account.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

1. Initiate a payout<\/h2>\n

The following tabs show how to make one-off and recurring payments. If you are fully PCI compliant<\/a>, you are allowed to make payout requests using raw card details. Otherwise, you must use tokenized card details<\/a> in your request.<\/p>\n\n

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

The following tabs show examples of the responses that you receive after a successful request.<\/p>\n\n

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

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

Track the transfer request by using the webhooks<\/a> 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.<\/p>\n

You can also view the transfer details in your Customer Area<\/a>.<\/p>\n

3. Test the payout flow<\/h2>\n

To test the payout flow with raw card details, make a POST \/transfers<\/a> request using our Visa test card<\/a> and Mastercard test card<\/a> details for the counterparty.card.cardIdentification<\/code> fields.<\/p>\n

See also<\/h2>\n