Confirm or decline payout

You can confirm or decline a submitted third-party payout using the /modifyRequest API call.

Confirming and declining payments can also be done manually, in your Customer Area > Transactions > Payouts.

Confirm a third-party payout

Confirm a third-party payout by calling the /confirmThirdParty endpoint:

Request

{
    "merchantAccount" : "TestMerchant",
    "originalReference" : "9913140798220028"
}
<?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>
    <confirmThirdParty xmlns="http://payout.services.adyen.com"> 
      <request> 
        <additionalData xsi:nil="true"/>
        <merchantAccount>TestMerchant</merchantAccount> 
        <originalReference>9913140798220028</originalReference> 
      </request> 
    </confirmThirdParty> 
  </soap:Body> 
</soap:Envelope>
merchantAccount=TestMerchant&originalReference=9913140798220028

Response

 {
    "pspReference" : "9913140798220028",
    "response" : "[payout-confirm-received]"
}
<?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:confirmThirdPartyResponse xmlns="http://payout.services.adyen.com"> 
      <ns1:response> 
        <pspReference xmlns="http://payout.services.adyen.com">9913140808680104</pspReference> 
        <response xmlns="http://payout.services.adyen.com">[payout-confirm-received]</response>
      </ns1:response> 
    </ns1:confirmThirdPartyResponse> 
  </soap:Body> 
</soap:Envelope>
pspReference=9914352327811826&response=%5Bpayout-confirm-received%5D

Your admin user assigns the permissions for confirming payment details. If they are unable to assign these permissions, they should contact Support Team.

Decline a third-party payout

Decline a third-party payout by calling the /declineThirdParty endpoint:

Request

{
    "merchantAccount" : "TestMerchant",
    "originalReference" : "9913140798220028"
}
<?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>
    <declineThirdParty xmlns="http://payout.services.adyen.com"> 
      <request> 
        <additionalData xsi:nil="true"/>
        <merchantAccount>TestMerchant</merchantAccount> 
        <originalReference>9913140798220028</originalReference> 
      </request> 
    </declineThirdParty> 
  </soap:Body> 
</soap:Envelope>
merchantAccount=TestMerchant&originalReference=9913140798220028

Response

{
    "pspReference" : "9913140798220028",
    "response" : "[payout-decline-received]"
}
<?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:declineThirdPartyResponse xmlns="http://payout.services.adyen.com"> 
      <ns1:response> 
        <pspReference xmlns="http://payout.services.adyen.com">9913140808680104</pspReference> 
        <response xmlns="http://payout.services.adyen.com">[payout-decline-received]</response>
      </ns1:response> 
    </ns1:declineThirdPartyResponse> 
  </soap:Body> 
</soap:Envelope>
pspReference=9914352333652404&response=%5Bpayout-decline-received%5D

Your admin user assigns the permissions for declining payment details. If they are unable to assign these permissions, they should contact Support Team.