Payout notifications

For each request to a third-party payout endpoint, we send you a notification to inform you of the outcome. For example, you receive a payout-submit-received response when you submit a payout, and a payout-confirm-received response when a payout is confirmed.

The originalReference field holds the PSP reference.

If a payout's state is changed in the Customer Area, you won't receive a response message but your server will still receive a notification.

We also send you a notification to inform you when a payout has been processed. This notification has the eventCode PAYOUT_THIRDPARTY. The success field indicates whether the payout was successful (true) or unsuccessful (false). If it is unsuccessful, the reason field has a short description explaining why.

Event Codes

The eventCode field holds information about the payout. The following table gives an overview of what some of the values mean. For more information on event codes, see Payment Notifications.

Events Description
PAYOUT_DECLINE Triggered when a payout is declined, and success is set to true.
PAYOUT_EXPIRE Triggered when a payout expires, and success is set to  true.
PAYOUT_THIRDPARTY Triggered when a payout has been processed. The payment is successful when success is set to true, and unsuccessful when success is set to false.
REFUNDED_REVERSED Triggered when the funds are returned from the bank. This can happen if the card is expired.

Code examples

The following example shows the response notification for a successful payout in JSON, FORM, and SOAP.

{
    "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