Skip to main content

Transaction Reporting

This guide covers how to monitor transaction volume and investigate individual payments from the PayKore dashboard. It's written for operations and finance teams — no coding required.


Overview page

When you log in, the Overview page shows four KPI cards summarizing recent activity:

  • Total volume — the sum of all transaction amounts over the selected date range, in naira.
  • Transaction count — the total number of transactions over the same range, regardless of amount.
  • Fees earned — the total fees collected, broken down by your own platform fee (if you use split payments) and PayKore's processing fee.
  • Active wallets — the number of wallets that had at least one transaction in the selected range.

A date range selector sits at the top of the page, letting you switch between preset ranges (Today, Last 7 days, Last 30 days, This month) or pick a custom start and end date. All four KPI cards and the transaction list below update together when you change the range.


Transaction list

Below the overview cards, the Transactions table shows every transaction in the selected date range, most recent first.

Filtering: use the filter bar above the table to narrow results by:

  • Status — Completed, Processing, Failed, Reversed
  • Type — P2P Transfer, Bank Transfer, USSD Payment, QR Payment, Split Payment
  • Date range — independent of the page-level selector, for fine-grained investigation

Searching: the search box accepts your own reference (the value you passed when creating the transaction) — useful when you're looking up a specific order or customer complaint and already know your internal order ID.

Columns:

ColumnMeaning
ReferenceYour own reference string for this transaction.
TypeThe transaction type (P2P, Bank Transfer, etc.).
AmountThe gross transaction amount, shown in ₦.
FeeThe total fee deducted, shown in ₦.
StatusA coloured badge — see below.
DateWhen the transaction was created.

Status badge colours:

  • 🟢 Completed — green
  • 🟡 Processing — yellow/amber
  • 🔴 Failed — red
  • 🔵 Reversed — blue

Transaction detail

Clicking any row in the transaction list opens its detail view, showing:

  • Full fee breakdown — every component of the fee (customer fee, platform fee, PSP cost where applicable), not just the total shown in the list.
  • Wallet IDs — both the source and destination wallet identifiers involved.
  • PSP reference — for bank transfers, the reference number from the receiving bank or payment processor. Use this when reconciling against a bank statement or when contacting PayKore support about a specific transfer.
  • Webhook delivery status — whether the webhook for this specific transaction was delivered successfully, and if not, how many retry attempts have been made so far. This is the fastest way to check "did our server actually get notified about this?" without asking your engineering team to check logs.

Exporting transactions

To export transactions for your own records or accounting software:

  1. Set your desired date range using either the page-level selector or the table's filter bar.
  2. Click Export to CSV.
  3. The downloaded file includes one row per transaction, with amounts shown in ₦ (naira), not kobo — so the export is ready to drop into a spreadsheet or accounting tool without any unit conversion.

Columns included in the export: reference, type, amount (₦), fee (₦), status, source wallet ID, destination wallet ID, created date, completed date.


Understanding transaction statuses

StatusWhat it means
CompletedThe money has moved. This is the final, successful state — no further action is needed.
ProcessingWe're waiting for the bank or payment network to confirm. This typically resolves within seconds to minutes, though bank transfers outside business hours can take longer.
FailedThe transaction did not go through. If money had already left a wallet, it has been automatically returned — you do not need to issue a manual refund.
ReversedA previously completed transaction was later reversed, usually due to a bank-initiated dispute or a manual correction. This is rare and worth investigating individually if you see it.

Next steps

  • Managing API Keys → — Create and manage the keys your engineering team uses to generate this data.
  • Settlements → — Understand how the fees shown here become a payout to your bank account.