Transactions
Search, filter and export terminal transactions, and handle refunds.
Every payment taken on one of your terminals appears in the Transactions area of the dashboard, usually within a few seconds of the customer tapping their card. This is where you check takings, answer customer questions and pull the numbers your bookkeeper needs.
The transaction list
The list shows your payments with the newest at the top. For each one you normally see:
| Column | What it tells you |
|---|---|
| Date and time | When the payment was taken, in your business's time zone |
| Amount | The value charged to the customer |
| Status | Approved, declined, refunded or pending |
| Payment method | Card scheme or wallet used, and the last digits of the card |
| Terminal | Which terminal took the payment |
Totals follow your filters
The summary figures above the list — count and total value — recalculate as you filter. Set your filters first, then read the totals.
Finding a transaction
Search
Use the search box for a specific payment. Useful things to search on:
- The amount, when a customer tells you what they paid
- The last four digits of the card
- The transaction or receipt reference from the customer's receipt
Filter
Filters narrow the list down to a slice of your business. Common ones:
- Date range — today, yesterday, this week, this month, or a custom range
- Terminal — a single terminal, useful if you run more than one till or location
- Status — for example approved only, or declined only
- Payment method — card scheme or wallet
- Amount range — to isolate unusually large or small payments
Filters combine, so "this week + terminal 2 + declined" is a valid view. Clear them all to get back to the full list.
Common jobs
- Cashing up: filter to today and read the total.
- Chasing a disputed payment: filter to the date, then search the amount.
- Checking a quiet terminal: filter by terminal over the last week.
Transaction details
Select any row to open the full detail for that payment. The detail view typically includes:
- Amount, currency, and any tip or surcharge applied
- Date, time and the status of the payment, including the time it was authorised
- Card scheme, card type and masked card number
- The terminal and, where relevant, the staff member signed in to it
- Authorisation and reference codes used by your bank and by Citizen Pay
- The payout the payment belongs to, once it has been settled — see Payouts
Quote the transaction reference whenever you contact Citizen Pay support about a specific payment. It is the fastest way for them to find it.
Declined payments
A declined payment still appears in the list, with a reason from the card issuer. Declines are decided by the customer's bank, not by Citizen Pay, so the customer will need to try another card or contact their bank. If a whole run of payments is declining on one terminal, that is a terminal problem rather than a card problem — see Troubleshooting.
Refunds
To be confirmed
Refund behaviour in the dashboard has not been finally confirmed for this guide. Treat the steps below as a description of the intended flow, and check with Citizen Pay before relying on them.
To refund a payment:
- Find the original transaction and open its detail view.
- Choose Refund.
- Enter the amount to refund. A full refund returns the whole amount; a partial refund returns part of it, for example when a customer keeps some of their order.
- Confirm. The refund appears in your transaction list as its own entry, linked to the original payment.
Things worth knowing:
- Refunds go back to the card the customer paid with. You cannot redirect a refund to a different card or to cash.
- The money usually takes a few working days to appear on the customer's statement — that timing is set by their bank.
- Refunds are deducted from your balance, so they reduce a future payout rather than being charged separately. See Payouts.
- Refunds are typically restricted to owners and managers. See Team.
Exporting transactions
Exports are the easiest way to hand figures to a bookkeeper or load them into accounting software.
- Apply the filters for the period you want, for example last month.
- Choose Export.
- Pick the format — CSV is the usual choice for spreadsheets and accounting packages.
- The file downloads to your computer, or arrives by email if the export is large.
An export contains one row per transaction with the same fields as the detail view, so you can total by day, by terminal or by payment method in a spreadsheet.
Reconciling with your bank
A transaction export lists individual payments; your bank statement lists payouts, which are batches of payments. To match one to the other, export by payout rather than by date. See Payouts.