Reconciliation Reports

NjiaPay provides a suite of reconciliation reports that help you verify every transaction processed through your account matches what your payment service providers (PSPs) report on their end. These reports are available as CSV downloads from the Merchant Portal under the Reconciliation tab.

Why Reconciliation Matters

When you process payments through NjiaPay, the flow involves multiple systems:

graph LR
    A[Your Customer] --> B[NjiaPay]
    B --> C[PSP e.g. Adyen]
    C --> D[Bank / Card Network]
    D --> C
    C --> B
    B --> A

Each system keeps its own records. Reconciliation is the process of cross-checking NjiaPay's records against the PSP's settlement files to make sure:

• Every successful payment in NjiaPay also appears in the PSP settlement
• The amounts match (no discrepancies in what was charged vs. what was settled)
• You can account for PSP fees, currency conversions, and net payouts
• No transactions are missing on either side

Available Reports

NjiaPay generates four reconciliation reports, each serving a different purpose in your monthly close process:

Guides

Example Workbook

Download this example Excel workbook to see how the four reconciliation reports look in practice, with sample data and ready-made analysis sheets:

The workbook contains six sheets:

Open the workbook in Excel or Google Sheets and explore the formulas in the last two sheets to understand how they reference the report data. You can use these sheets as starting templates for your own reconciliation process.

Typical Reconciliation Workflow

Here is how a finance team typically uses these reports each month:

Step 1: Upload PSP Settlement Files

Before downloading reports, make sure you have uploaded PSP settlement data for the month. Check the coverage timeline. Your goal is a fully blue bar for each PSP.

Step 2: Start with NjiaPay Transactions

Download the NjiaPay Transactions report for your period. This gives you the complete list of successful payments. Use it as your master checklist.

Step 3: Review Successful Payments Reconciliation

Download the Successful Payments report. This contains every successful payment along with its reconciliation status. Filter by exists_in_psp and exists_in_njia:

• exists_in_njia = True, exists_in_psp = True rows are matched: both NjiaPay and the PSP agree. Check the break_gross_amount column: False means the amounts agree, True means investigate.
• exists_in_njia = True, exists_in_psp = False rows are unmatched: the PSP settlement hasn't been received yet. Common reasons: settlement file not yet uploaded, transaction too recent, or the PSP doesn't have settlement integration yet (e.g. StartButton).
• exists_in_njia = False, exists_in_psp = True rows are PSP-only: the PSP settlement has a transaction that NjiaPay doesn't know about. This means the payment was made outside of NjiaPay, either via a manual payment link created directly in the PSP dashboard, or from historical transactions that predate your NjiaPay integration.

Step 4: Review Refunds, Chargebacks & Pending

Download the Refunds, Chargebacks & Pending report. This shows non-success transactions: payments still in Pending state (customer may have abandoned checkout), refunds, and chargebacks. Use this to:

• Track your checkout drop-off rate (pending items)
• Reconcile refund amounts against your records
• Monitor chargeback exposure

Step 5: Account for Fees & Settlements

Download the Fees & Settlements report. This shows PSP-level items that are not tied to individual transactions: batch payouts to your bank account, monthly processing fees, dispute holds and releases, and currency conversion charges.

Step 6: Cross-check Totals

Use a pivot table or SUMIFS in your spreadsheet to compare:

How Reports Are Generated

NjiaPay's reconciliation engine runs daily. It:

1. Collects all successful NjiaPay transactions for the selected period
2. Imports PSP settlement files (uploaded via the portal)
3. Matches each NjiaPay transaction to its PSP counterpart using the PSP reference ID
4. Classifies each record as: successful payment (matched or unmatched), non-success item (refund/chargeback/pending), or operational entry (fees/settlements)
5. Outputs the four CSV reports

Understanding exists_in_njia and exists_in_psp

These two boolean flags tell you where a transaction was found:

Column Conventions

Across all reports, you will notice these conventions:

• Timestamps follow your timezone. CSV exports use the timezone from the timezone selector, locked to the offset at the start of the selected month. If no timezone is explicitly selected, it defaults to your browser's locale timezone.
• njia_ prefix: columns from NjiaPay's side of the ledger.
• psp_ prefix: columns from the PSP settlement file.
• break_ prefix: discrepancy flags. True means the values don't match between NjiaPay and PSP; False means they agree.
• exists_in_njia / exists_in_psp: boolean flags showing whether a transaction was found on each side. See Understanding exists_in_njia and exists_in_psp above for when each combination occurs.
• njia_merchant_ref_id: your own reference ID that you passed when creating the payment intent. This is the most important field for matching against your internal systems.
• Amounts in major units by default. See Amounts: Major Units vs. Minor Units for currency-specific details and when to use _minor_units columns instead.