Force Resolve Payout
Operator escape hatch (F06): force a stuck submit_failed/timeout payout
to terminal failed and re-credit the customer (CORRECTION_IN). Permissioned
(send_withdrawal_payout) + customer-scope enforced. Idempotent via
_recredit_failed_payout’s idem_tag.
An approved gateway withdrawal debits the balance at send while payout_status stays in-flight; an ambiguous PSP outcome flips it to submit_failed(timeout) — a money-debited limbo where retry/decline/re-approve all 409. When the reconciler can never auto-resolve the row (PSP keeps returning non-terminal, or the connector is gone), this is the only path that returns the customer’s money.
Re-credit is EXACTLY ONCE: _recredit_failed_payout no-ops when a CORRECTION_IN
with this idem_tag already exists, the row is taken FOR UPDATE, and the only
valid source state is submit_failed (a second call lands on terminal failed
and 409s before any second credit). idem_tag pins the attempt so the credit
is keyed to the attempt that was actually debited.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Successful Response