Search

Are you looking for test card numbers?

Would you like to contact support?

Payout notifications

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 webhook notifications. 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 notification 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 notification 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 notification 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, a response to your /payout request with resultCode: Authorised means that the payout was successful. You will also receive a notification with:

  • eventCode: PAYOUT_THIRDPARTY
  • success: true

If the issuer refuses the payout, you receive a response with resultCode set to Refused, and a notification with:

  • eventCode: PAYOUT_THIRDPARTY
  • success: false

If the cardholder did not accept the payout, we will return the funds back to your account, and you will receive a notification with:

  • eventCode: PAIDOUT_REVERSED

Code examples

The following example shows a PAYOUT_THIRDPARTY notification 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