Ask the receiver of a payment the bank sent to return it (camt.056)
POST
/transfers/realtime/{id}/return-requestsPath parameters
idstringRequiredHeaders
Idempotency-KeystringOptionalSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
operatorstringRequiredreasonstringOptionalreason_codestringRequiredReturns
200 OK
created_atstring · date-timeRequireddecided_bystringRequireddirectionstringRequiredidstringRequiredmsg_idstringRequiredpayment_idstringRequiredExample lpay_2tVh8nqLxq4GbDe0K1F6S9zRcWm
railstringRequiredreasonstringRequiredreason_codestringRequiredrequested_bystringRequiredresponse_msg_idstringRequiredresponse_reasonstringRequiredresponse_reason_codestringRequiredreturn_payment_idstringRequiredExample lpay_2tVh8nqLxq4GbDe0K1F6S9zRcWm
statusstringRequiredRequested, acknowledged, accepted, pending, rejected, returned (outbound); received, honoured, refused (inbound); failed
Errors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503