Payment events and reconciliation

Let verified provider events move orders, catch the events you missed, keep an append-only ledger and match every payout to the cent.

By Erik Bergstedt, Agent Wranglers. Updated 20 October 2026.

Required

Let provider events move the order
Required
Fulfil, grant access or mark a refund only when a verified provider event or API read says the money moved. Map each event type to one order transition.
Wait for payment methods that settle later
Required
Keep an order in a processing state while a slow payment method settles, and fulfil only on the final success event.
Sweep for missed events every hour
Required
Run a job at least every hour that lists recent payments and refunds at the provider and fixes orders whose state disagrees.
Record every money movement in an append-only ledger
Required
Write each charge, refund, fee, dispute and payout as a new ledger row with the provider's object ID, and never update or delete a row.
Reconcile every payout
Required
Within 2 business days of each provider payout, match it to the transactions it contains, to your ledger and to the bank statement.