Railbed, in plain language
A short reference for the words you will see in checkout, the dashboard and your payment records.
On this page
#Payment and checkout terms
| Term | Meaning |
|---|
| TermPayment link | MeaningA request for one payment with a set amount; useful for an invoice or deposit |
| TermCheckout page | MeaningA reusable product page; every buyer creates a separate payment |
| TermPricing table | MeaningA reusable checkout with several plans and optional two-way price choices |
| TermPayment widget | MeaningA compact checkout placed inside your own website |
| TermBuy button | MeaningA website button that opens a Railbed checkout in an overlay |
| TermTracking link | MeaningA shareable, status-only view of a payment request |
| TermReference | MeaningYour own invoice or order label, attached to a payment |
| TermPayment ID | MeaningRailbed's identifier for one payment, beginning with pay_ |
| TermOrder | MeaningThe purchase record containing items, totals, customer and one or more payment attempts; see Orders |
| TermCustomer | MeaningThe purchase history associated with one email address in one mode; see Customers |
| TermPayment attempt | MeaningOne try at paying an order; a retry can belong to the same order |
| TermSuccess URL | MeaningThe thank-you destination opened from checkout after payment confirmation |
| TermSmart Routing | MeaningThe checks and preferences that choose eligible card providers for a buyer |
| TermProvider | MeaningThe licensed service whose page takes the buyer's card details and payment |
#Wallet and money terms
| Term | Meaning |
|---|
| TermUSDC | MeaningThe dollar-denominated stablecoin used for merchant settlement |
| TermPolygon | MeaningThe blockchain network used for that settlement |
| TermSelf-custody wallet | MeaningA wallet whose private keys you control |
| TermPayout wallet | MeaningYour saved public Polygon address for receiving settlement |
| TermDeposit address | MeaningA payment-specific intermediate address; it is not the wallet setting you should change |
| TermSettlement | MeaningThe funds transfer associated with a confirmed payment |
| TermNet receipt | MeaningThe reported amount that reached your wallet after applicable fees |
| TermHeld payment | MeaningA payment marked Being reviewed because confirmation checks need attention |
| TermAccept as paid | MeaningYour explicit decision to accept an eligible held payment with the amount that arrived |
#Integration terms
| Term | Meaning |
|---|
| TermTest mode | MeaningA separate environment of simulated payments; no card is charged |
| TermLive mode | MeaningThe mode for real card payments |
| TermAPI key | MeaningA private credential that lets your server or plugin access Railbed in a specific mode |
| TermWebhook | MeaningA signed notification from Railbed to a server when a payment event happens |
| TermSigning secret | MeaningA private value your receiver uses to verify a webhook |
| TermFulfilment | MeaningYour delivery record, separate from payment status; see Orders and fulfilment |
| TermIdempotency | MeaningRetrying the same operation without accidentally creating the same order's payment twice |
For the meaning of a specific status and what to do next, see Payments and statuses. For API fields and event payloads, use the developer reference.
Updated · This page as Markdown