What your customer sees
Understand the card checkout, provider choice and return journey so you can confidently guide a customer through payment.
On this page
From your link to payment
- Billed to
- Alex Morgan
- Reference
- INV-0042
Set the amount, then share its link or QR code, or email it.
Your buyer enters an email, chooses an available provider and pays there by card.
Review the amount received in your dashboard.
Railbed confirms payment status. Settlement goes to the wallet you control.
- Your customer opens the invoice, checkout page or embed. They see your business, product and price. A pricing table first asks them to choose a plan.
- They give an email address, answer any details you ask for, and choose Continue to pay. An invoice can prefill the email you entered for its customer.
- What happens next follows the provider choice of the checkout, store or invoice. Smart Routing opens the best provider for that buyer straight away, and One provider opens the provider you picked. Buyers choose shows every card provider that can take them in one list, with a recommended Best match; under it the list may say why (Picked for your country or Lowest minimum payment). When Apple Pay or Google Pay is on the list and the buyer's browser can pay with it, it comes right after Best match: Apple Pay on an iPhone, iPad or Mac set up for it, Google Pay on Android and in Chrome.
- The provider opens in a new tab, which shows Opening secure payment until the provider's page loads. If it takes more than a few seconds, the tab offers a Continue to link for that provider. The buyer enters card details and completes any checks on the provider's page.
- The original checkout tab waits for confirmation. When the payment is marked paid, it shows the result or follows your success URL.
When the browser can't open a tab (a blocked pop-up, or the built-in browser of an app such as Instagram), the provider opens in the same tab. Coming back to the checkout then asks whether they finished, as below.
How Smart Routing chooses providers
Smart Routing looks at the buyer's country, the checkout currency, the amount, each provider's minimum and whether the provider is working today. It keeps the card providers that can take the buyer and ranks them. You don't need a rule for each country, though you can put the providers in your own order. Provider choice sets how each checkout uses the ranking.
The list can differ between buyers and change over time. Test mode uses a fixed example list, so it is not a live availability check. A low amount may have no provider that can take it, even though Railbed accepted the price.
Choose which card providers buyers see
Under Integrations → Card providers, each provider has an Offer to buyers switch. Turn one off and your buyers are never offered it, in Test or Live, on checkout pages, invoices, your store and anything your developer builds; it reads Turned off by you. Smart Routing picks from the rest. Only an owner can change the switches, and each change appears in your account's activity.
At least one card provider stays on. Interac e-Transfer (a bank payment) and Venmo don't count toward that, and nor do the providers that pay on another network unless your payout wallet can take them.
If checkout pages, unpaid invoices, your Shopify store or WooCommerce are set to One provider with the provider you're turning off, a dialog lists them. Choose where they send buyers instead (Smart Routing or another provider you offer) and Move and turn off, or keep the provider on and nothing changes.
Providers you turn off no longer count toward the smallest payment you can take. If the ones left all start at $5, a $3 price is refused with words saying so, and Card providers notes that card payments start at $5.00 while you have them turned off. A checkout set to One provider with a provider you turned off sends buyers to Smart Routing's pick when If it can't take a buyer, use Smart Routing instead is on, and stops them when it's off.
Before a switch turns a provider off, Railbed runs your prices (your checkouts' prices and the amounts you were paid in the last 30 days) against the providers that would be left. If some buyers would have no card provider for one of them, it asks first, for example Buyers outside the US would have no card provider for your 4.99 USD price. Keep the provider on, or turn it off anyway; you can turn it back on at any time. Turning a provider on never asks.
Under the list, Buyers who couldn't pay appears when a Live payment couldn't start in the last 7 days. Each line says why in a sentence, how many times it happened, when it last happened and the latest amount; when a provider you turned off could have taken those buyers, it names the provider. A buyer who tried more than once is counted each time, and nothing was charged.
The page also shows each provider's status and minimum:
| Status | What it means |
|---|---|
| Available | Offered to buyers it can take |
| Unstable or Unavailable | The provider itself is having trouble; it comes back on its own |
| Turned off by you | Your own switch; it stays off until you turn it on |
| Turned off by Railbed | Railbed's team paused it for now |
| Not working, paused by Railbed | Railbed's own checks found its payments aren't going through; it comes back once they pass |
| Not offered | Listed but never offered, or not offered with your payout wallet; its line says why |
Put card providers in your order
- Under Integrations → Card providers, choose Change order.
- Drag a provider by its handle, or use its arrows. With a keyboard, focus the handle and press the up and down arrow keys.
- Choose Save order.
Test and Live mode each keep their own order, so save it in each mode you sell in. Only an owner can change it, and each change appears in your account's activity.
Each buyer still sees only the providers that can take them, now in your order, and Best match is the first of them, so a checkout on Smart Routing sends buyers straight to it. A buyer who comes back without paying still sees the providers they already tried last, and a checkout set to One provider still sends buyers to that provider first. Reset to Smart Routing goes back to ranking the providers for each buyer's country.
Apple Pay, Google Pay and other networks
Buyers can pay with Apple Pay or Google Pay through card providers such as Stripe and Topper, which pay on Polygon like any card. A few providers pay on another network instead, to the same wallet address:
| Provider | Pays | Prices it takes |
|---|---|---|
| Apple Pay (as a provider of its own) | USDC on Ethereum | USD, EUR or GBP |
| Alipay and WeChat Pay | USDT on Ethereum | USD, EUR or GBP; first for buyers in mainland China, Hong Kong and Macau |
| Rampnow | ETH on Ethereum | USD or GBP |
| Venmo | PayPal USD on Ethereum | US buyers, at the order's dollar value |
| Cash App | USDT on BNB Chain | US buyers |
Railbed values what arrives in dollars, so a payment never needs your decision because of the coin or the network it came on. These providers are offered only where they work for you:
- An ordinary wallet. In Live, they're offered only with an ordinary self-custody payout wallet, such as MetaMask, Coinbase Wallet or Rabby, where the same address receives on every network, so there's nothing to set up. A smart contract wallet such as a Safe can't take them, because it may not exist on those networks; Card providers then lists them as Not offered and says what turns them on.
- Larger orders on Ethereum. Forwarding money from Ethereum costs more, and the cost comes out of your share, so the Ethereum providers take an order only where that cost stays at most 3% of it and the amount clears the network's minimum. That line moves with network costs (about $75 for Apple Pay when forwarding costs $2.25, a few dollars when it costs cents), so Card providers shows their minimum as "From about".
With One provider, Apple Pay, Alipay, WeChat Pay, Rampnow or Venmo can be the provider only with If it can't take a buyer, use Smart Routing instead on, because their minimum changes from day to day. In Test mode, Apple Pay, Alipay and WeChat Pay are on the list from about $75 and Rampnow from $6, with any wallet.
Google Pay as a provider of its own is paused for now. Buyers still pay with Google Pay through card providers such as Stripe.
Interac e-Transfer
Buyers in Canada paying in Canadian dollars can pay by Interac e-Transfer from their bank, through Paytrie, on orders of 100 CAD or more. Smart Routing lists it after Banxa, Topper and Coinbase, the card providers it prefers in Canada.
Venmo
Buyers in the US can pay from the Venmo app. No new tab opens: the checkout itself shows what to send and where.
- The buyer sends PayPal USD (PYUSD), the dollar coin in Venmo's Crypto tab, where 1 PYUSD is worth $1. An order priced in another currency is shown at its US dollar value, fixed when the buyer starts paying. The checkout shows the amount, the address with a copy button and a QR code, and the steps in Venmo, whether the buyer already holds PYUSD or buys it first.
- Since the buyer sends the money themselves, Venmo is offered only when Railbed can tell the buyer is in the US and while at least 15 minutes are left on the payment. A buyer already shown the Venmo details keeps them until the payment closes.
- Venmo pays on Ethereum, to the same wallet address, from about $3. In Live it needs an ordinary self-custody payout wallet, as Apple Pay does.
- The checkout shows the result as soon as the payment arrives, like any other provider.
Venmo appears under Integrations → Card providers like the other providers, so you can turn it off or put it in your order.
Why there are two tabs
The Railbed tab stays open so it can report the verified result and send the customer back to your store. The provider's own final page may lead somewhere else that your success URL doesn't control.
Tell customers to keep the original checkout tab open and return to it after paying. If their browser blocks new tabs, payment continues in the same tab, and they may need to go back to the Railbed page to see the result.
If a card is declined
A Live decline is shown by the card provider. Railbed doesn't receive a direct decline signal, so your dashboard may still show Open or In progress. The buyer can use Choose another way to pay to go back to the full provider list before the payment expires, including on checkouts that sent them straight to a provider.
Don't assume an in-progress payment means the card was charged. If the buyer believes they were charged, open the payment and use Check now (how) before asking them to pay again.
If the buyer comes back without paying
When the buyer comes back to the Railbed tab and Railbed hasn't seen their payment yet, the page asks Did you finish paying with Stripe? (naming their provider) and goes on: "If you did, stay here. This page updates by itself, usually within a few minutes. If Stripe's page didn't open, didn't take your card or asked for something you couldn't give, choose another way to pay." Choose another way to pay comes first; Reopen Stripe goes back to the provider.
The provider list then shows the providers they already tried last, marked You tried this, and Best match goes to the first one they haven't tried. A checkout on Smart Routing sends them straight to a provider they haven't tried, when one can take them. Every attempt at the same order counts, so starting the checkout again doesn't send them back to the same provider. A checkout set to One provider shows the list once its buyer has tried that provider, with it last.
A buyer who opens the page again later, after a reload or on another device, sees Waiting for your payment: "You started paying with Stripe. If you finished there, this page updates by itself, usually within a few minutes. If you didn't, choose a way to pay again." Choose a way to pay opens the list.
If the payment expires after the buyer reached a provider, the page tells them not to pay twice: "If you finished paying at Stripe, don't pay again. A payment still on its way counts, and [your business] will see it." Your support email follows when you've set one. Money that still arrives settles the expired payment.
Embedded checkouts and buy buttons ask the same questions inside their card.
If the page says Being reviewed or Underpaid
Money arrived but didn't pass every check needed to confirm it. The buyer's page reads Your payment is being reviewed, or Your payment is underpaid when less than the full amount arrived, and says you will contact them about what happens next. In your dashboard the payment reads Needs your decision (with Underpaid beside it), or Not received when its money may have gone elsewhere. Ask the buyer to wait while you check it. It is not an instruction to top up the original payment.
Thank-you pages and receipts
A success URL runs from the original checkout tab after the payment is confirmed. If that tab is closed, Railbed can't redirect it. Closing the page doesn't cancel money already sent.
Without a success URL, Railbed shows an on-screen receipt. Railbed doesn't email buyers a receipt for checkout pages; an invoice can email its customer one for each payment. If your store sends order emails, those come from the store or your own integration.
For manual delivery, check for Paid in your dashboard. For automatic delivery, connect signed webhooks or authenticated payment checks. Never use the buyer's screenshot, browser redirect or thank-you page as the only payment proof.