Skip to content

Reconcile payments

Reconciliation compares your gateway's own transaction records against what ChargeOn recorded in Transaction History, over a date range you choose, and sorts every transaction into Matched, Unmatched or Amount Mismatch. Run it on demand, or turn on a daily schedule and let it watch for you.

Before you start

  • You need the ChargeOn Reconciliation Manager permission set (or admin access).

  • Reconciliation only works with 14 of ChargeOn's 20 gateways. If your gateway is not on this list, it will not appear in the picker at all:

    Authorize.Net, Braintree, CyberSource, FatZebra, Forte, GoCardless, NMI, PayPal, Razorpay, Shift4, Sola, Stax, Stripe, USAePay

    Not covered: Adyen, Checkout.com, Elavon, Global Payment, Linked2Pay, PayTrace. For a full, per-gateway capability breakdown, see the gateway reference.

Run reconciliation on demand

  1. Open the ChargeOn app and go to the Transactions Reconciliation tab.
  2. Choose a Payment Gateway.
  3. Enter a From and To date. The range cannot exceed 31 days.
  4. Click Run Reconciliation.

What you should see

A summary of counts — Matched, Unmatched, Amount Mismatch — followed by a row for every transaction in range, each showing the gateway's own amount, the matching ChargeOn payment and amount if one was found, and its status. If more than 1,000 transactions fall in your date range, only the first 1,000 are shown — narrow the range to see the rest.

A gateway can be slow to publish its own transactions

Some gateways take up to 24 hours to make a transaction available through their own reporting API. A transaction that shows as Unmatched simply because it is too recent is not a real problem — re-run reconciliation later and it typically resolves itself.

Once you have results, click Export to Excel to download the full row-by-row breakdown.

Turn on scheduled monitoring

Rather than running reconciliation yourself, let ChargeOn check on a schedule and only tell you when something is actually wrong.

  1. In the same Transactions Reconciliation tab, scroll to Scheduled Reconciliation Monitoring.
  2. Turn on Enable Scheduled Monitoring.
  3. Choose the Gateway to Monitor.
  4. Set the Run Time — pick an off-hours time.
  5. Set Lookback Hours — how far back each run checks. Between 1 and 744 (31 days).
  6. Enter a Notification Email. ChargeOn only sends to it when a run finds an unmatched or mismatched transaction — a clean run stays silent.
  7. Click Save Schedule.

This is the job the quick start guide told you to schedule

Turning this toggle on is how the reconciliation job gets scheduled — there is no separate trip to Setup → Schedule Apex for it. See the quick start guide's background jobs step (Part 7) for how this fits alongside ChargeOn's other scheduled jobs, and why an unscheduled job runs silently — never, with no error anywhere.

What you should see

Once a run has happened, a line under the schedule settings shows the last run's date and time, and how many issues it found.

If it does not work

Symptom Likely cause What to do
Your gateway does not appear in the picker It is one of the six gateways reconciliation does not cover See the list above, or the gateway reference. Rely on your gateway's own dashboard instead
Everything shows Unmatched for transactions from the last day or so The gateway has not published them to its own reporting API yet Re-run later — this is normal, not a configuration problem
No transactions found at all for the range you chose The date range does not cover when the payments actually happened, or the gateway genuinely processed nothing in that window Widen the range and confirm against a known transaction date
The schedule toggle turns itself off after saving Your permission set may not grant edit access here Ask your administrator to check your permission set