Perform a test transaction
Run a test transaction immediately after payment processor onboarding to verify that your terminal is paired correctly, your processor configuration is active, and the tip flow behaves as expected — before accepting real guest payments. A test transaction catches configuration errors early, when they are easiest to resolve.
Important — use a designated test card, not a real guest card. Test transactions using a real guest card create a live charge that must be manually voided or refunded. Always use your processor's official test card number. See step 4 below for Stripe and Adyen test card details.
On this page
- Before you begin
- When to run a test transaction
- Run the test transaction
- Test the tip flow
- Verify success in the Payment Dashboard
- Cleanup — void or refund the test charge
- Troubleshooting
- Escalation
Before you begin
Permission: Configure Payment Settings (under Payments) — Required to complete post-onboarding configuration including test transactions. Manage Payment Settings (under Payments) also opens this page.
- KYC (Know Your Customer) / KYB (Know Your Business) verification must be in Approved status before a test transaction will succeed. To check your KYC status, see Understand KYC/KYB status and center payment capabilities.
- Your card reader or payment terminal must be paired and showing as online. If the terminal is offline or not paired, re-pair it before proceeding.
- Have the processor's official test card number ready (see step 4 below). Do not use a real guest card.
When to run a test transaction
Run a test transaction in the following situations:
- Immediately after completing payment processor onboarding — confirm KYC approval, terminal pairing, and the full payment flow before going live.
- After pairing a new card reader or replacing a terminal — verify the new hardware communicates with the processor correctly.
- After changing processor configuration — for example, after updating payment methods, surcharge settings, or switching between test and live mode.
Run the test transaction
Create a test invoice. To keep test data clean, use a zero-cost or low-cost service or product. You can archive the test service afterward.
Add the test service to the invoice and proceed to checkout.
On the payment screen, select Use Card Reader to route the payment through the paired terminal.
Use the processor's designated test card:
Stripe test card
- Card number:
4242 4242 4242 4242 - Expiry: any future date (for example,
12/34) - CVC: any three-digit number (for example,
123) - ZIP: any five-digit number if prompted
Adyen test card
- Adyen provides test card numbers through its test card documentation portal. Consult the Adyen test card guide for your region and card brand. Do not use a real card.
Note. Stripe test cards are only accepted in Stripe's test mode. If your account is in live mode, the Stripe test card number is rejected by the processor. Contact Zenoti Support if you are unsure whether your processor is in test mode.
- Card number:
Present or swipe the test card on the terminal when prompted.
Confirm the payment in Zenoti. The invoice status should update to reflect a successful payment.
Test the tip flow
If your organization collects tips, verify the tip flow as part of your test:
- Before collecting payment in step 5 above, enter a tip amount in the tip field on the payment screen.
- Complete the payment with the test card.
- Confirm in the Payment Dashboard that the total collected matches the invoice amount plus the tip amount.
If the tip field does not appear, navigate to your payment settings and confirm that tipping is enabled for the center.
Verify success in the Payment Dashboard
After completing the test payment:
- Navigate to Payments > Payment Dashboard.
- Locate the test transaction in the transaction grid. You can filter by date or search by the last four digits of the test card.
- Confirm:
- Status shows Success (or Captured / Settled, depending on your processor's terminology).
- Amount matches the invoice amount, including the tip if you added one.
- Payment Method reflects the card brand used.
- Click the Reference column value to open the transaction detail and review the full record.
If the transaction does not appear in the Payment Dashboard within a few minutes, see Troubleshooting below.
Cleanup — void or refund the test charge
Test charges must be removed from your accounts receivable. Do not leave them as open or settled transactions.
Void within the settlement window (preferred):
- Open the test transaction in the Payment Dashboard.
- Select the void action before the transaction settles (typically within the same business day; exact window depends on your processor).
- Confirm the void. The transaction status updates and no funds are transferred.
Refund after settlement:
If the settlement window has passed, issue a full refund instead:
- Open the invoice for the test transaction.
- Select Refund Invoice and refund the full amount.
- Confirm the refund. Processing time depends on your processor.
Archive test data (optional but recommended):
If you created a dedicated test guest profile or test service for this transaction, archive or delete those records after cleanup to prevent them from appearing in guest search or reporting.
Troubleshooting
| Symptom | Likely cause | Resolution |
|---|---|---|
| Terminal shows "Connection error" | Terminal not paired or offline | Re-pair the terminal in the device management settings; check the internet connection on the terminal's network. |
| Transaction declined | Incorrect test card number | Use the processor's official test card. For Stripe, use 4242 4242 4242 4242. For Adyen, consult the Adyen test card guide. Do not use a real card. |
| Transaction not appearing in Payment Dashboard | Onboarding not complete | Confirm KYC status is Approved in the processor onboarding screen. Transactions from centers with pending KYC will not appear. |
| Tip not applying | Tipping not configured | Navigate to payment settings and verify that tipping is enabled for the center. |
| Payment succeeds in Zenoti but processor dashboard shows no record | Processor in test mode / live mode mismatch | Confirm whether your Zenoti configuration and processor account are both in the same mode (test or live). Contact Zenoti Support if you cannot determine the mode. |
| Invoice status does not update after payment | Terminal connection dropped during payment | Check terminal connectivity. If the invoice remains open, attempt the test payment again. If the issue persists, contact Zenoti Support. |
Escalation
If your test transaction fails after checking the items above, contact Zenoti Support through the in-product Help menu or your account manager.
Topics that require escalation:
- Test transaction completes in Zenoti but does not appear in the processor's own dashboard.
- Persistent card declined error when using the correct test card.
- Processor dashboard shows a different amount than the Zenoti invoice.
- Terminal remains offline after re-pairing.