Payments
The Payments page is a ledger of every recorded payment across your business. It gives you a single view of what has been collected, how customers paid, which invoices the payments are tied to, and which completed payments can be reversed or refunded.
Open Payments from the main navigation.
When to use Payments
Use Payments when you need to:
- See what your business has collected over a given period.
- Look up a specific payment by customer name.
- Verify how a customer paid (card, cash, check, or bank transfer).
- Find which invoice a payment is linked to.
Before you start
- Invoices must exist first. Payments are never created directly on the Payments page — they are recorded through the invoice payment flow.
- Stripe must be connected for card charges and pay links. Go to Settings → Online payments to connect or verify your Stripe account. Cash and check payments do not require Stripe.
- At least one invoice must be in a payable state (Sent or Draft) before a payment can be recorded against it.
- Refund access requires Stripe write permission and a verified email address. ToolbagCRM's Refund action returns the full remaining amount on an eligible completed Stripe charge; it does not offer an amount field. If Stripe reports a partial refund, ToolbagCRM preserves that refund in the linked invoice's payment history.
- Reversing a non-Stripe payment requires Payments write access. The reversal reason is required and becomes part of the payment's status history.
The payment list
The payment list opens with Track all recorded payments beneath the page title. While a customer search, status, or invoice filter is active, the header instead shows how many payments match.
Status tabs
Use All, Pending, Completed, Failed, Refunded, or Voided to filter the full payment list. Changing the status resets the list to its first page while preserving the customer search and any active invoice filter.
Search
Search by customer name to filter the full payment list. ToolbagCRM keeps the search and status in the page URL, so browser Back and Forward restore the earlier filter state.
When View payments opens the page from an invoice, an Invoice filter active card limits results to that invoice. Use View invoice to return to it or Clear invoice filter to search the full payment ledger.
What each row shows
- Customer name
- Amount — the payment total
- Payment method — Credit Card, Bank Transfer, Cash, or Check
- Check # — the check number for a manually recorded check payment; otherwise an em dash
- Status badge — Completed, Pending, Failed, Refunded, or Voided
- Date — when the payment was recorded
- Invoice link — View invoice to open the linked invoice detail
- Refund — opens the matching charge in Settings → Online payments for confirmation; shown only for completed Stripe payments to team members with Stripe write access
- Reverse payment — opens a required-reason confirmation for an eligible completed payment that was not processed by Stripe; shown only to team members with Payments write access
How payments are recorded
Payments are not created directly from this page. They are recorded through the invoice payment flow:
| Method | How it works |
|---|---|
| Charge Card | From the invoice detail, click "Charge Card" to charge the customer's card on file through Stripe. |
| Pay Link | Send the customer a pay link from the invoice detail. They pay by card through Stripe. |
| Record payment | From the invoice detail, record a cash or check payment collected outside Stripe. Enter any positive amount up to the remaining balance. |
Each method records a payment entry that appears in this ledger. Payments are not created here, but eligible completed payments can be reversed or refunded from this page.
Check sales tax readiness
After Stripe is connected, team members with read access to the Stripe integration can open Settings → Online payments. When Stripe reports active tax settings or a registration, the Tax tab shows a Sales tax setup card with the connected account's Stripe Tax settings status and any registrations Stripe reports, including the country, state when present, and whether each registration is active. The tab may also appear if ToolbagCRM cannot load the tax status; use its Retry action. If the tab is absent, these settings have not been reported as active and no registrations were returned.
This card is a readiness check only. Stripe Tax does not automatically calculate tax on quotes or invoices from these settings. The separate Tax (%) field on a quote lets your team enter a rate manually; ToolbagCRM applies it after the quote discount, and the accepted quote's total carries through to its draft invoice. Your business must decide the correct rate and remains responsible for filing and remitting the tax it collects.
Treat Needs setup, No tax registrations reported by Stripe, or a registration marked Not active as not ready. Completing Stripe Tax setup does not set the quote's Tax (%) field or enable automatic tax calculations.
Reverse a non-Stripe payment
Use this flow when a completed cash, check, or other non-Stripe payment was recorded in error:
- Open Payments and find the completed payment. If an invoice sent you here after a failed void attempt, View payments opens this page already filtered to that invoice's records.
- Select Reverse payment. On a phone, use the same action on the payment card; on a desktop, use it in the payment row.
- Enter the required reason, then select Reverse payment in the confirmation dialog.
- Confirm that the payment shows Voided. ToolbagCRM keeps the reason in status history and reopens a Paid invoice when the remaining completed payments no longer cover its total.
Stripe-linked payments do not offer Reverse payment. Use their Refund action so Stripe processes the refund and ToolbagCRM can reconcile the result.
In the ToolbagCRM demo, Refund opens a simulated confirmation. Select Refund once to mark the payment Refunded for the current demo session; the status remains after reloading the page. Select Never mind or press Escape to cancel and try again. No live Stripe refund occurs.
Payment methods
ToolbagCRM records payments in four method categories:
| Method | Typical source |
|---|---|
| Credit Card | Stripe card charges (online or card-on-file) |
| Bank Transfer | ACH or bank transfer through Stripe |
| Cash | Manual Record payment action on the invoice |
| Check | Manual Record payment action on the invoice; requires the check number and matching amount confirmation |
Tips
- Use the status tabs to focus on failed or refunded payments when investigating issues.
- Select View invoice on any payment to see the full invoice detail and payment history.
- Use a partial cash or check payment when the customer pays only part of the balance; ToolbagCRM leaves the invoice open for the remainder.
- Review the customer, amount, charge, and Invoice balance before / Invoice balance after values in the Stripe refund dialog before confirming. Other completed payments can keep the invoice balance at zero after this charge is refunded; the invoice reopens only when the remaining completed payments no longer cover its total. ToolbagCRM refunds the charge's full remaining amount and refreshes the Stripe transactions after it succeeds.
Troubleshooting
The page shows "No payments recorded yet"
This is the normal empty state when no invoices have been paid yet. Create an invoice, send it to a customer, and record a payment through the invoice detail page.
A payment shows "Failed" status
A Failed payment did not complete. Open the linked invoice and check the payment history before trying the charge again or sending a fresh pay link. For a recent Stripe charge, check its status under Settings → Online payments → Recent transactions. If the cause is unclear, contact ToolbagCRM support rather than assuming the card was declined.
Payments are not appearing after a customer paid
Payments recorded through pay links appear in the ledger once Stripe confirms the charge. Check the linked invoice and the Pending status tab first. For recent card charges, review Settings → Online payments → Recent transactions; this list shows recent charges, not a complete payment history. If the charge or its status remains unclear, contact ToolbagCRM support before asking the customer to pay again.
Refund is not shown for a payment
The Refund action appears only for a completed Stripe payment that has a Stripe payment reference. Your role also needs Stripe write access. Cash, check, pending, failed, and already-refunded payments cannot be refunded from this page.
Reverse payment is not shown for a payment
The Reverse payment action appears only for an eligible completed payment that is not linked to Stripe. Your role also needs Payments write access. Stripe-linked payments must use Refund and cannot be manually reversed in ToolbagCRM.
ToolbagCRM could not look up the charge to refund
On the Stripe page, select Retry in the warning to look up the charge again. Review the matched charge before confirming the full refund. If the lookup still fails, do not refund a different transaction. Check the linked invoice's payment history and Settings → Online payments → Recent transactions, then contact ToolbagCRM support if the charge remains unclear. Recent transactions is not a complete payment history.
The refund was submitted but its status is not confirmed
If the refund dialog says Refund was submitted, but we couldn't confirm its status yet, select Check again. ToolbagCRM checks the charge status again without submitting another refund. If it remains unconfirmed, check the linked invoice's payment history and Settings → Online payments → Recent transactions, then contact ToolbagCRM support before taking another action. Do not submit the refund again while its status is uncertain.
The invoice shows a partial refund
When Stripe reports a partial refund, the linked invoice keeps the original captured amount and lists each refund amount and date plus the remaining Net amount. A Paid invoice reopens when the net payment no longer covers its total. The Refund action remains available for the charge's remaining amount when the payment is still eligible.
A check payment is rejected
Enter a check number and type the payment amount again in Confirm amount (USD). The confirmation must exactly match the payment amount, and the payment cannot exceed the invoice's remaining balance.
"Charge Card" button is disabled on an invoice
The Charge Card action requires a connected Stripe account with charges enabled. Go to Settings → Online payments and complete the onboarding process. The button is also disabled if the invoice has no card on file for the customer.
Stripe onboarding does not continue after Add information
Open Settings → Online payments and select Set up payments or Continue onboarding, then select Add information. Complete verification in the secure Stripe window. If that window does not appear, allow pop-ups for ToolbagCRM and select Restart onboarding.
If ToolbagCRM reports that the secure session took too long or the Stripe form could not load, select Restart onboarding for a fresh session. Select Reload page when it is offered, then use Continue onboarding to resume. Information already saved with Stripe remains there. If the problem continues, select Contact support.