Honour or refuse a return request another participant sent (camt.029, and the return itself when honoured)

POST/wire-return-requests/{id}/respond

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

decisionstringRequired

Honour or refuse

operatorstringRequired

reasonstringOptional

reason_codestringOptional

Returns

200 OK

The Wire Return Request object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/wire-return-requests/{id}/respond' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "decision": "string",
    "operator": "string"
  }'

Response200

{
  "created_at": "2026-09-17T14:30:00Z",
  "decided_by": "string",
  "direction": "string",
  "id": "wrrq_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "imad": "string",
  "omad": "string",
  "reason": "string",
  "reason_code": "string",
  "requested_by": "string",
  "response_imad": "string",
  "response_reason": "string",
  "response_reason_code": "string",
  "return_wire_id": "wire_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "status": "string",
  "updated_at": "2026-09-17T14:30:00Z",
  "wire_id": "wire_2tVh8nqLxq4GbDe0K1F6S9zRcWm"
}