v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-061066160.9 KB
CashOut

Initiate a cashout

Initiates a cashout request.

post/cashouts

Request body

descriptionstring

Allowed and returned only when you provide the counterparty.transferInstrumentId field.

Your description of the cashout transfer. This description is used by most banks as the transfer description. We recommend sending a maximum of 140 characters, otherwise the description may be truncated.

If you do not provide a description, Adyen generates a description automatically. This generated description is not returned in the response.

Supported characters: [a-z] [A-Z] [0-9] / - ? : ( ) . , ' + Space.

idstring

The ID of the resource.

instructingBalanceAccountIdstring required

The unique identifier of the balance account that initiates the cashout request.

referenceForBeneficiarystring

Allowed and returned only when you provide the counterparty.transferInstrumentId field.

The reference that is sent to the recipient of a cashout transfer. This reference is also sent in all webhooks related to the cashout transfer, so you can use it to track the status of the transfer.

If you do not provide a reference for the beneficiary, Adyen generates one automatically. This generated reference for the beneficiary is not returned in the response.

Supported characters: a-z, A-Z, 0-9.

transferInstrumentIdstring

Use counterparty.transferInstrumentId instead.

The unique identifier of the counterparty transfer instrument.

Response

OK - The request has succeeded.

descriptionstring

Allowed and returned only when you provide the counterparty.transferInstrumentId field.

Your description of the cashout transfer. This description is used by most banks as the transfer description. We recommend sending a maximum of 140 characters, otherwise the description may be truncated.

If you do not provide a description, Adyen generates a description automatically. This generated description is not returned in the response.

Supported characters: [a-z] [A-Z] [0-9] / - ? : ( ) . , ' + Space.

idstring required

The unique identifier of the cashout reference.

instructingBalanceAccountIdstring required

The unique identifier of the balance account that initiates the cashout request.

referenceForBeneficiarystring

Allowed and returned only when you provide the counterparty.transferInstrumentId field.

The reference that is sent to the recipient of a cashout transfer. This reference is also sent in all webhooks related to the cashout transfer, so you can use it to track the status of the transfer.

If you do not provide a reference for the beneficiary, Adyen generates one automatically. This generated reference for the beneficiary is not returned in the response.

Supported characters: a-z, A-Z, 0-9.

transferInstrumentIdstring

Use counterparty.transferInstrumentId instead.

The unique identifier of the counterparty transfer instrument.