Payment Reconciliation

Payment Reconciliation (Operations → Payment Reconciliation) is the daily reconciler's review queue. It compares Aforo's record of each payment against the source of truth at the gateway and surfaces any divergence for an operator to resolve.

Mismatch review queue

Mismatches are grouped into tabs by review state:

Tab / `reviewStatus`	Meaning
Pending Review (`PENDING`)	Awaiting an operator decision
Resolved (`RESOLVED`)	Reconciled
Ignored (`IGNORED`)	Marked a false positive
Escalated (`ESCALATED`)	Routed to ops
All Runs	Reconciliation job history

Mismatch types

Type	Meaning
`STATUS_DIVERGED`	Status differs between Aforo and the gateway
`AMOUNT_MISMATCH`	Amounts differ
`MISSING_LOCALLY`	Exists at the gateway, not in Aforo
`MISSING_AT_GATEWAY`	Exists in Aforo, not at the gateway
`OTHER`	Anything else

Each mismatch records the gateway (stripe, paypal, razorpay, adyen, worldpay), the gateway event ID, when it was discovered, and both the Aforo state and gateway state (shown side-by-side in the detail drawer). Resolving, ignoring, or escalating captures a resolution note (up to 2048 chars).

Reconciliation runs

Runs move through RUNNING → COMPLETED (or FAILED) and record events fetched, events compared, and mismatch count. Use Trigger ad-hoc run with a gateway selector to reconcile on demand.