Skip to main content

​
What this is

This is the Card Ledger page under the card issuing module in the merchant dashboard (usually opened from a card’s … menu -> View Card Ledger; can also be reached directly at /issuing/card-ledger). The ledger records a card’s balance changes entry by entry: each row has a begin balance, this entry’s amount, and an end balance, used for card-level reconciliation and statement checking. Use this page to verify how a specific card’s balance moved, whether a charge/refund posted, or to look up an entry by reference or card number.

​
Steps

Open the card ledger:
  1. From a card’s … menu on the Cards page, select View Card Ledger to open that card’s ledger; or go directly to the ledger page to see all entries.
  2. When opened from a specific card, a Route card filter tag appears at the top, indicating you are viewing only that card.
Filter and search:
  1. Use the Type filter to filter by transaction type (single select).
  2. Use the Status filter to filter by transaction status (Approved / Declined).
  3. Use the Reference ID search box to search by reference number (recent searches remembered).
  4. Use the Card number search box to search by card number (non-digit characters are ignored automatically).
  5. Use Date range to filter by time period.
  6. Active filters appear as filter tags; click Clear all to reset.
Export:
  1. Click Export in the toolbar to generate a ledger report via the report dialog.
  2. Or select rows, then click Export selected in the selection bar to export the chosen entries as CSV.

​
Fields and statuses

List columns: Transaction status (filter options): Transaction types (Type filter options; badge color by fund direction: credit green / debit orange / neutral gray):
The ledger’s type vocabulary is more granular than the Overview page’s (e.g. Overview shows “Card Recharge” where the ledger shows “Deposit” for the same event); rely on what each page actually displays.

​
Edge cases and troubleshooting

  • List shows “No ledger entries yet”: this card has no balance changes yet; the hint reads “Card balance changes will appear here.”
  • Filtered to “No entries match your filters”: the current filters have no match; the hint reads “Try adjusting your filter criteria.” — clear filters and check again.
  • A “Route card” tag appears at the top: you entered from a specific card and are viewing only that card; clear the filter to see a broader range (if permitted).
  • An extra amount in parentheses below the amount: the billing currency differs from the transaction currency; the amount in parentheses is the billing-currency amount.
  • Loading / refresh hints: on first load it shows “Loading ledger entries…”; during a background refresh it shows “Refreshing ledger entries…” at the bottom.
  • Can’t find by card number: the card number search automatically strips non-digit characters and matches on digits only; input with spaces or masking also works.
  • List shows red error text: data failed to load; the error message is shown directly in the table area — retry later.

​
Common questions (Q&A)

  • Q: Where do I find a card’s ledger? / How do I check a card’s transaction history? A: On the Cards page, open a card’s … menu and select View Card Ledger to open that card’s ledger.
  • Q: What’s the difference between the ledger and card transactions? A: The ledger is an entry-by-entry record of a card’s balance changes (with begin/end balance for reconciliation); card transactions are more focused on authorization/settlement detail.
  • Q: How do I read begin balance, amount, and end balance? A: End balance = begin balance +/- this entry’s amount; each row is a before/after snapshot of one balance change.
  • Q: How do I look up a ledger entry by reference or card number? A: Use the Reference ID or Card number search box at the top.
  • Q: What do the ledger statuses “Approved” and “Declined” mean? A: Approved = the transaction went through; Declined = it was rejected.
  • Q: How do I export the card ledger? A: Click Export in the toolbar to generate a ledger report via the dialog, or select rows and click Export selected to export a CSV.
  • Q: Why does the amount show two numbers (one in parentheses)? A: The transaction currency and billing currency differ; the parenthesized number is the billing-currency amount.
  • Q: What are “Deposit” and “Card Recharge” in the type list? A: They’re all balance-change transaction types — credits (green) like Deposit / Transfer In / Refund, and debits (orange) like Authorization / Card Recharge / Fee.
  • Q: I only want to see one card’s ledger — how? A: Open that card’s … menu -> View Card Ledger; the top will show a Route card tag limiting the view to that card.