Search

Are you looking for test card numbers?

Would you like to contact support?

Online-payment icon

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