v50

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

Transfers

Return a transfer

Initiates the return of previously transferred funds without creating a new transferId.

post/transfers/{transferId}/returns

Path parameters

transferIdstring required

The unique identifier of the transfer to be returned.

Headers

Idempotency-Keystring

A unique identifier for the message with a maximum of 64 characters (we recommend a UUID).

Request body

referencestring

Your internal reference for the return. If you don't provide this in the request, Adyen generates a unique reference. This reference is used in all communication with you about the instruction status.

We recommend using a unique value per instruction. If you need to provide multiple references for a transaction, separate them with hyphens ("-").

Response

OK - the request has succeeded.

idstring

The unique identifier of the return.

referencestring

Your internal reference for the return.

status'Authorised' | 'Declined'

The resulting status of the return.

Possible values: Authorised, Declined.

transferIdstring

The unique identifier of the original transfer.