Are you looking for test card numbers?

Would you like to contact support?

Default icon

Block a payout

Block a payout to the merchant's bank account.

This operation works at merchant level.

Blocking payouts usually require a 4-eye policy through the Adyen Customer Area (CA)

The /blockPayout call allows blocking payouts programmatically.

You can request to block a payout if the following criteria are satisfied:

  • The payout is in the Payable state.
  • There are no pending changes for the specified payout. 

Payout states

A payout can go through the following states:

Request parameters

To block payout for a merchant, make a POST /blockPayout request specifying:

Name Type Required Description
merchantCode String
A merchant code string holds a value to identify a merchant. Format:
  • Either: MerchantAccount.Merchant_Code
  • Or: Merchant_Code

Response parameters

If there are no errors in the request, the call returns a pspReference.If any issues occur during the process, the call returns one or more warning or error messages.

Name Type Returned by default Description
pspReference String
A reference to uniquely identify the request.
warnings String
List containing one or more warning messages.
Returned when the request is not correctly processed.
errors String
List containing one or more error messages.
Returned when the request fails.



<soap:Envelope xmlns:soap="" xmlns:xsd="" xmlns:xsi="">
        <blockPayout xmlns="">


<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="" xmlns:xsd="" xmlns:xsi="" xmlns:ns0="">