Debit reversal

Reverse prior debit when compensation is required.

Path

POST /debit-reversal

When used

• wallet was debited
• OpenPoly business flow failed after debit
• user funds must be returned

Request body

Same mutation shape as debit, but:

• direction = debit_reversal
• idempotency_key identifies reversal operation, not original debit lookup

Rules

• reversal must be idempotent
• remote reference for reversal should be distinct from original debit
• if final remote state is unclear, return unknown -> OpenPoly may mark manual review