Reverse loan account transaction
Creates an immutable compensating transaction and preserves reversal lineage. Idempotency is enforced in the use case via the X-Request-ID header (X-Idempotency fallback): a reused request ID with different facts yields 409. A malformed UUID yields 422; an unknown transaction yields 404.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Canonical idempotency request ID. Falls back to X-Idempotency when absent.
"550e8400-e29b-41d4-a716-446655440010"
Fallback idempotency request ID used when X-Request-ID is absent.
"550e8400-e29b-41d4-a716-446655440011"
Path Parameters
Loan account identifier (UUID).
"550e8400-e29b-41d4-a716-446655440000"
Original repayment transaction identifier (UUID).
"550e8400-e29b-41d4-a716-446655440001"
Body
YYYY-MM-DD effective date of the reversal.
"2026-06-14"
Product profile version applied to the reversal.
1"1.0.0"
Operator-supplied reversal reason.
1Optional jurisdiction code.
"BR"
Response
OK
Reversed amount (2 d.p. string).
"125.00"
ISO-8601 effective date of the reversal.
"2026-06-14"
Loan account UUID.
"550e8400-e29b-41d4-a716-446655440000"
Reversed original transaction UUID.
"550e8400-e29b-41d4-a716-446655440001"
Product profile version applied to the reversal.
"1.0.0"
Operator-supplied reversal reason.
Compensating reversal transaction UUID.
"550e8400-e29b-41d4-a716-446655440002"
Jurisdiction code applied to the reversal.
"BR"
Idempotency request ID echoed from the request.
"550e8400-e29b-41d4-a716-446655440010"

