---
title: "Payout webhook"
description: "Learn about the outcomes of your payout requests."
url: "https://docs.adyen.com/online-payments/online-payouts/payout-webhook"
source_url: "https://docs.adyen.com/online-payments/online-payouts/payout-webhook.md"
canonical: "https://docs.adyen.com/online-payments/online-payouts/payout-webhook"
last_modified: "2020-10-23T15:10:00+02:00"
language: "en"
---

# Payout webhook

Learn about the outcomes of your payout requests.

[View source](/online-payments/online-payouts/payout-webhook.md)

We are no longer accepting new integrations with the [Payout API](https://docs.adyen.com/api-explorer/Payout/latest/overview); use the [Transfers API](https://docs.adyen.com/api-explorer/transfers/latest/overview) instead. With the Transfers API, you can:

* Handle multiple payout use cases with a single API.
* Use new payout functionalities, such as instant payouts.
* Receive webhooks with more details and defined transfer states.

If you are:

* Building a new integration, refer to [Webhook structure and types](/payouts/payout-service/webhook-types/) to integrate with the Transfers API.
* Already integrated with the Payout API, reach out to your Adyen contact for information on how to migrate to the Transfers API.

## Payouts to bank accounts or wallets

To know whether a payout to a [bank account or wallet](/online-payments/online-payouts#payouts-to-bank-accounts-and-wallets) was successful, you need to [set up a webhook](/development-resources/webhooks/configure-and-manage#expose-an-endpoint-on-your-server). The response to a `/submitThirdParty` request only indicates that the request has been received, not whether the payout was successful.

The following `eventCode`s 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](/online-payments/online-payouts/instant-payouts), 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**.

#### JSON

```json
{
    "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"
            }
        }
    ]
}
```

#### Soap

```xml
<?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>
```

#### Form

```html
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
```
