Developer Documentation

Reversals

Transaction Reversals

Financial records must not be deleted. Reversals are handled through reversal_requests.

Endpoints:

• POST /v1/admin/transactions/{id}/reversal-request
• GET /v1/admin/reversal-requests
• GET /v1/admin/reversal-requests/{id}
• POST /v1/admin/reversal-requests/{id}/approve
• POST /v1/admin/reversal-requests/{id}/reject
• POST /v1/admin/reversal-requests/{id}/process

Processing an approved reversal creates a new reversal transaction and compensating ledger entries. The original transaction and ledger rows remain immutable.

Recommended pilot policy:

• Finance or admin requests the reversal.
• A separate reviewer approves it.
• Processing is audited and reviewed in the ledger.