Test and Live mode

Practice the buyer experience without moving money, then prepare a separate checkout for real customers.

On this page

Check the mode before you create

Switch modes from the business block at the top of the dashboard's sidebar: open it, then use the Test mode switch. On means Test mode; off means Live. The block shows the current mode under your business name, and in Test mode the app shows a Test mode banner and labels so you can tell which records you are viewing.

What changesTest modeLive mode
Card paymentsSimulated; no card is chargedReal payments through available card providers
Wallet card on HomeSimulated money received in the period you choose, in dollarsUSDC balance read from your wallet on Polygon
Invoices, checkouts, orders, customers and paymentsSeparate Test recordsSeparate Live records
Provider listFixed for practiceDepends on current availability and buyer eligibility
WebhooksReal signed HTTP deliveries for simulated eventsReal signed HTTP deliveries for actual events

Business details, branding, team members and the payout wallet are shared across both modes. Changing them while viewing Test mode still changes them for Live.

Run a practice payment

  1. Turn on Test mode and create an invoice or checkout with a sample price, such as $49.
  2. Choose Open it to try a payment: on a checkout's Share tab, or on the invoice's page. This opens the buyer link as your team, so this browser can simulate payments for seven days. Continue with an email address you use for testing and choose one of the available Test providers.
  3. Railbed opens a simulated provider page. Choose Simulate successful payment. You do not enter card details.
  4. Return to the original checkout tab. It updates to the paid result, or follows your success URL if you set one.
  5. Open Payments in Test mode. Find the payment, confirm Paid, and inspect the timeline and simulated receipt.

You can also open Orders to inspect the purchase and its attempts, then open its customer. These are Test records. A simulated Paid status does not represent a real charge or settlement.

Practice the exceptions too

Create a new Test payment for each completed-payment scenario. A declined card can be retried on the same payment.

  • Simulate an underpayment: half the amount arrives, and the payment reads Needs your decision, with Underpaid beside it. Open its details to see why and try Accept as paid.
  • Simulate declined card: the payment stays open. Return to the checkout tab, choose Choose another way to pay, and try another provider. You can then simulate a successful payment on the same checkout.
  • Leave a payment unfinished: see how an open or in-progress payment differs from a paid one.

A Live card decline happens on the provider's page and is not directly reported to Railbed. The payment may stay open or in progress until it is paid or expires. Test mode teaches the UI and integration behavior; it does not prove which providers will approve a real buyer.

A Test checkout or invoice is marked Test mode on its Share card, in the copy confirmation and in its QR code's file name, including the Share cards on the setup screens. Anyone outside your team who opens it is told it's a test page and can't start or simulate a payment. A Test checkout's Share tab, and a Test invoice's page, say when people opened it from outside Railbed in the last seven days. Don't share or print a Test link: choose Recreate in Live on the Test checkout's Share tab, or create the invoice in Live, and share that one.

When a browser outside your team is refused, the message says how your team tries that page instead:

The Test pageWhat the message points to
A checkoutTest on your site on the checkout's Share tab
An invoiceOpen it to try a payment on the invoice's page in the dashboard
A checkout session your server madeTurn on Test payments in this browser on Developers

To try a Test checkout embedded in your own site, use Test on your site. Without it, the embed shows This checkout isn’t live yet to everyone, your team included: a frame on another site can't read the test access your browser keeps for Railbed's own pages.

A Live checkout's or invoice's Share card says Buyers pay real money here. To try the buyer’s steps without paying, switch to Test mode. while buyers can pay it.

  • Confirm the full Polygon payout address in Settings against the wallet you control.
  • Review your business name, logo, support email and displayed Railbed fee.
  • Turn off Test mode so the dashboard is in Live, and create the invoice or checkout there.
  • Open that exact buyer link and confirm its price, currency, description and appearance.
  • Copy the Live embed code again if you are using a button or widget.
  • Confirm how you will deliver the order after Paid, and what you will do with a payment that needs your decision.
  • If you use a store or API integration, connect the matching Live key and Live webhook endpoint.

Opening a Live checkout is different from completing a card payment. A successful Test payment does not move funds or demonstrate real settlement.

Where did my checkout go?

Check the mode first. A Test link, payment or key is not listed in Live mode, and vice versa. Switching modes changes the records you see; it does not delete them.

The buyer URL already identifies its checkout or payment. Your current dashboard mode does not change what a customer sees when they open a previously shared URL.

Updated · This page as Markdown