Are you looking for test card numbers?

Would you like to contact support?

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

Payout webhook

Learn about the outcomes of your payout requests.

Payouts to bank accounts or wallets

To know whether a payout to a bank account or wallet was successful, you need to set up a webhook. The response to a /submitThirdParty request only indicates that the request has been received, not whether the payout was successful.

The following eventCodes are important when you make payouts to bank accounts or wallets:

  • PAYOUT_THIRDPARTY: The user reviewing the payout confirmed it. The success field indicates whether we received the payout request. Possible values:

    • success: true. We received your payout request, and will send it to the financial institution. When approved, the funds are paid out within 2 business days. In case the financial institution rejects the request, you will receive a webhook event with eventCode: PAIDOUT_REVERSED.
    • success: false. The request failed. The reason field includes a short description of the issue. Review the reason, fix the issue if possible, and resubmit the payout request.

  • PAYOUT_DECLINE: The user reviewing the payout declined it. The success field of this webhook event is always set to true.

  • PAYOUT_EXPIRE: 7 days have passed since the payout was submitted, and the reviewer has neither confirmed nor declined it. The success field of this webhook event is always set to true.

  • PAIDOUT_REVERSED: The financial institution rejected the payout. We will return the funds back to your account.

Instant payouts

When making instant payouts to a card, you will get a response to your /payout request with resultCode: Received. For a successful payout, you will then receive a webhook event with:

  • eventCode: PAYOUT_THIRDPARTY
  • success: true

If the issuer refuses the payout, you will receive a webhook event with:

  • eventCode: PAYOUT_THIRDPARTY
  • success: false

Code examples

The following example shows a PAYOUT_THIRDPARTY webhook event with success: true.

{
    "live" : "false",
    "notificationItems" : [
        {
            "notificationRequestItem" : {   
                "amount" : {
                    "value" : 500,
                    "currency" : "EUR"
                 },

                "eventCode" : "PAYOUT_THIRDPARTY",
                "eventDate" : "2011-01-01T15:30:17.377+02:00",
                "merchantAccountCode" : "YourMerchantAccount",
                "merchantReference" : "Payout-0001",
                "paymentMethod" : "visa",
                "pspReference" : "ThePaymentPspReference",
                "originalReference" : "ThePayoutPspReference",
                "reason" : "Approved",
                "success" : "true"
            }
        }
    ]
}
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"  xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <ns1:sendNotification xmlns:ns1="http://notification.services.adyen.com">
      <ns1:Notification>
        <live xmlns="http://notification.services.adyen.com">false</live> 
        <notificationItems xmlns="http://notification.services.adyen.com"> 
          <notificationRequestItem> 
            <amount> 
              <currency xmlns="http://common.services.adyen.com">EUR</currency> 
              <value xmlns="http://common.services.adyen.com">500</value> 
            </amount> 
            <eventCode>PAYOUT_THIRDPARTY</eventCode>
            <eventDate>2011-01-01T15:30:17.377+02:00</eventDate>
            <merchantAccountCode>YourMerchantAccount</merchantAccountCode>
            <merchantReference>Payout-0001</merchantReference>
            <paymentMethod>visa</paymentMethod>
            <pspReference>ThePaymentPspReference</pspReference>
            <originalReference>ThePayoutPspReference</originalReference>
            <reason>Approved</reason>
            <success>true</success> 
          </notificationRequestItem> 
      </ns1:Notification>
    </ns1:sendNotification>
  </soap:Body>
</soap:Envelope>
originalReference=7914447213528916&reason=&merchantAccountCode=TestMerchant&eventCode=PAYOUT_THIRDPARTY&operations=&success=true&paymentMethod=bankTransfer_NL&currency=EUR&pspReference=7914447213809209&merchantReference=Rest+Noti&value=400&live=false&eventDate=2015-10-13T07%3A29%3A40.00Z