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
Invoice
A bill for one customer: line items or one amount, shared as a link or QR code or emailed by Railbed, paid in full or in parts. See Invoices. In the API, invoices made outside the builder are called payment links
Invoices made in other apps
Invoices for one amount made while setting up, in Telegram or Slack, through the API or by an AI assistant. Listed with the rest; see Invoices made in other apps
Invoice number
The number Railbed gives each invoice you build, such as INV-0042
Due date
The day an invoice should be paid by. It counts as due until that day ends everywhere, so no customer is late early
Part payment
A payment toward part of an invoice, when you let the customer pay in parts
Tip
An extra amount a customer adds when paying an invoice that offers tips
Checkout page
A reusable product page; every buyer creates a separate payment
Pricing table
A reusable checkout with several plans and optional two-way price choices
Payment widget
A compact checkout placed inside your own website
Buy button
A website button that opens a Railbed checkout in an overlay
Tracking link
A shareable, status-only view of an invoice made in another app
Reference
Your own order or purchase order number, attached to a payment or invoice
Payment ID
Railbed's identifier for one payment, beginning with pay_
Order
The purchase record containing items, totals, customer and one or more payment attempts; see Orders
Customer
The purchase history associated with one email address in one mode; see Customers
Payment attempt
One try at paying an order; a retry can belong to the same order
Success URL
The page your customer goes to after paying, set under After payment, send them to (or After payment, send buyers to on a checkout)
Provider
The licensed service whose page takes the buyer's card details and payment
Smart Routing
The checks and preferences that choose which card providers can take each buyer, and the provider choice that sends buyers straight to the top one
Buyers choose, One provider
The other provider choices: buyers pick from the ranked list, or every buyer goes to the provider you pick
Best match
The provider marked first in the list a buyer sees
Card provider order
The order you put your card providers in under Integrations → Card providers; buyers see the providers that can take them in that order. See Put card providers in your order
Payment statuses
Status
Meaning
Open
The payment exists, but the buyer hasn't reached a provider yet
In progress
The buyer reached a card provider; Railbed is waiting for confirmation. Don't deliver yet
Paid
The payment passed its checks, or you accepted it; safe to deliver once
Needs your decision
Money reached your wallet but didn't pass a check, so it isn't paid until you decide. Team members who can't accept payments see Needs a decision. The API status is held
Underpaid
Shown beside Needs your decision when the only problem is that less than the full amount arrived
Not received
The money may have gone elsewhere, so there is nothing to accept and nothing is counted as received. The API status is held
Declined
A simulated payment declined in Test mode. A Live card decline isn't reported, so the payment stays Open or In progress, then expires
Expired
Nobody paid in time. Money that arrives late can still settle it
Canceled
You canceled the invoice or session before it was paid
Saved but not created yet; it has no page and can be changed or deleted
Sent
Created and ready to pay; the customer hasn't opened it yet
Viewed
The customer opened it
Partially paid
Some of it is paid and the rest is still due
Overdue
Not fully paid by its due date
Paid
Paid in full
Void
You stopped it; it can't be paid any more
Expired
Its time to be paid ran out
Wallet and money terms
Term
Meaning
USDC
The dollar stablecoin your card sales settle in
Polygon
The blockchain network almost every card payment settles on; a few providers pay on another network
Self-custody wallet
A wallet whose private keys you control
Payout wallet
Your saved public wallet address (on Polygon) for receiving your sales
Other payout wallets
Further wallets an owner saves in Settings: ones an invoice can pay instead of the payout wallet, and one for each network with its own kind of address for crypto payments. See Other payout wallets
Crypto payments
An opt-in extra in Settings that lets buyers pay with crypto instead of a card. See Crypto payments
Deposit address
An address made for one payment that forwards the money to your wallet; never use it as your payout wallet
Settlement
The money reaching your wallet for a confirmed payment
Net receipt
The amount that reached your wallet after fees
Account terms
Term
Meaning
Owner, Manager, Developer, Sales, Viewer
The five team roles. Sales makes and sends invoices and sees only their own; see Your team and roles
Test mode
A separate copy of your account for simulated payments; no card is charged. Test pages open only for your team
Live mode
The mode for real card payments
Two-factor sign-in
An optional six-digit code from an authenticator app, asked for after your usual sign-in. See Two-factor sign-in
Recovery code
One of ten single-use codes you save when you turn on two-factor sign-in, for signing in without your phone
Integration terms
Term
Meaning
Secret key
A private credential, also called an API key, that lets your server, plugin or automation tool use Railbed in one mode, with Full access or Read only
AI assistant
An app such as Claude or ChatGPT connected to one business through Railbed's MCP server, or an agent you approved through agent sign-in. Manage them under Developers → AI assistants; see AI assistants
Webhook
A signed message from Railbed to a server when a payment event happens
Signing secret
A private value your server uses to check that a webhook came from Railbed