Understand your wallet and settlement
Know where the money goes, how received totals are calculated, and why your checkout price and wallet balance can differ.
On this page
Your wallet is yours
Railbed sends each payment to the payout wallet saved for it, as USDC on Polygon for almost every card payment. It keeps no balance for you and there's no payout to request. Home shows your checkout activity and your wallet; it isn't a separate Railbed account.
Use a self-custody wallet whose keys you control. Your public address belongs in Settings; your seed phrase and private key never do.
To turn what's in your wallet into money in your bank, follow Move money to your bank.
Balance and received totals are different
| Number | What it represents |
|---|---|
| Your wallet on Home, in Live | The USDC balance read from your payout wallet on Polygon, shown in dollars with when it was checked. It can include money from elsewhere and reflect transfers out, and it leaves out money that arrived as another coin or on another network, such as Ethereum or Bitcoin |
| Received for the period you choose, and Received today | Reported net receipts from Railbed payments, in dollars, whatever coin or network each arrived in |
| Received in Test mode | Simulated receipts, marked Simulated; no money in a real wallet |
| Original order amount | The price the buyer was asked to pay, in the checkout currency |
| You received on a payment | The reported net amount for that payment, in dollars. A payment that arrived in a coin other than a dollar coin also shows the amount of that coin, valued at its price when the payment was checked |
A wallet balance goes down when you send money out of the wallet. Received is a record of receipts, so the two numbers don't need to match.
The wallet card also counts payments under Needs your decision (their money is already in your wallet) and Buyers paying now (not received yet). A buyer who went to a card provider more than half an hour ago with no payment back moves to Went to a provider (no payment yet), which opens those payments. Verify balance opens your wallet on the public Polygon explorer, and in Live, Move to your bank opens a short guide.
Why the amount received differs
Your checkout can be priced in USD, EUR, GBP, CAD, AUD, INR or SEK, but almost every card payment settles as USDC on Polygon. A few providers pay on another network: Apple Pay (as a provider of its own), Alipay, WeChat Pay, Rampnow and Venmo on Ethereum, where forwarding to your wallet costs more and comes out of your share, and Cash App as USDT on BNB Chain. Provider pricing, conversion and fees affect what arrives.
When your account has a Railbed fee, Settings → Payout wallet shows what comes out of each card payment: the card provider's charge, a 1% network fee and your Railbed fee. Use the rate shown for your account; not every business has the same one.
The fee and payout wallet are locked when a payment starts. Later changes apply to payments started afterwards, so use the payment's own details when looking into an older one.
An illustrative amount in these docs is not a promise of what you'll receive. The buyer's provider quote and the payment's reported settlement have the actual figures.
What Not reported yet means
A payment can be Paid before the amount that reached your wallet is reported. The dashboard shows Not reported yet rather than guessing from the order price or what the provider sent.
Those payments are left out of received totals until the amount is reported, and Home's Received card says how many, for example 1 paid payment isn't in the total until its amount is reported. Open the payment for its latest details.
Check a particular receipt
- Open Payments and choose the payment.
- Confirm its mode, payment ID, order amount and status.
- Read You received and the Payout wallet for that payment.
- For a Live payment, open its transaction in the timeline on that network's explorer (Polygonscan for most).
- If it reads Needs your decision or Not received, follow Payments that need your decision before delivering the order.
A live balance read can fail on its own. If the wallet card shows an error, choose Try again; a failed later check keeps the last balance with when it was read. An error doesn't mean a payment failed or that the wallet is empty.
Change the payout wallet
Only an owner can change the payout wallet.
- Go to Settings → Payout wallet.
- Choose Connect a different wallet and pick the wallet, or paste the new public address into Polygon address. On Home in Live, the wallet card's Ending … label turns into Change wallet and opens the same wallet list.
- Choose Save settings, review the full address in Change your payout wallet?, and choose Change wallet. With crypto payments on, you also confirm the new wallet works on every network.
Settings shows which wallet app a connected address came from. Railbed refuses an address that can't receive your payouts: a token's own address (such as USDC's contract), Railbed's own fee address, an example address from documentation, a payment's deposit address, or a contract that isn't a wallet on Polygon.
A wallet change needs a sign-in from the last five minutes. If yours is older, Railbed asks you to sign in again first (Sign in again to save your payout wallet. What you entered stays here.); nothing changes until you do, and the address you entered is kept for you to save.
The business's first payout wallet, added during setup, accepts a sign-in from the last hour instead, since there's no saved wallet yet for anyone to redirect. A wallet added after Railbed support removed yours counts as a change and needs the five minutes. If someone else saved a wallet while you were adding the first one, yours isn't saved: Railbed says This account changed while you were saving. Reload and review the latest settings. Reload to see the saved wallet, and change it from there if it isn't the right one.
After the change, Railbed:
- Records it under the wallet in Settings (Changed on … by … from …, with the previous address, or no saved wallet for the first, and the wallet app it came from) and in the owners' latest activity (Payout wallet added for the first, Payout wallet changed after that).
- Signs you out of every other device, so only the browser you used stays signed in.
- Emails the business's owners and, where they're connected, alerts Telegram and Slack.
If you see a change you didn't make, sign in and change the wallet back.
Payments already in progress keep their saved address; in Payments, an open or in-progress payment that will settle to the old address says Pays the previous wallet. An invoice made in another app that still pays the old wallet, and whose customer hasn't reached a card provider yet, can be replaced in one step: its page offers Replace link, which makes the same invoice paying the current wallet and cancels the old one. Keep access to the old wallet for the payments that stay on it. Changing the setting doesn't move the old wallet's balance.
Other payout wallets
An invoice can pay a different wallet of yours instead of the payout wallet, for example one you keep for a client or one part of the business.
- Under Settings → Payout wallet → Other wallets, choose Add a wallet.
- Give it a Name your team will recognise (up to 40 characters; buyers never see it) and paste its Polygon address, then choose Continue.
- Check the full address and choose Save wallet.
A business can save up to ten. Then pick one under Pays to in an invoice's Payment settings (Pay another wallet). An invoice never takes a typed address. Card payments to that wallet settle as USDC on Polygon, and such an invoice takes card payments only.
Each wallet gets the same protections as the payout wallet. Only an owner can add or remove one, after a sign-in from the last five minutes. Railbed checks it the same way, and again whenever those checks change; if a saved wallet stops passing, it reads Can't take Live payments, says why, and invoices can't pay it in Live. Every change is recorded in the owners' latest activity, emailed to the owners, sent to Telegram and Slack where they're connected, and signs you out of your other devices.
To stop using a wallet, choose Remove, then Remove wallet. Railbed won't remove a wallet while an unpaid invoice pays it (for one made in another app, until its customer starts paying): void or cancel those invoices first, or wait until they're paid or expired. A payment that already started keeps the wallet it started with and still settles there, so keep access to the wallet until those payments finish.
Wallets on other networks
While crypto payments are on, Wallets on other networks holds one wallet for each network with its own kind of address, such as Bitcoin, TRON and Solana. Choose Add (or Change) beside a network, paste the address and save it; Railbed checks it against that network's format and checksum first, with the same sign-in, records and alerts. A network without a wallet isn't offered to buyers.
A buyer who pays in that network's coins (BTC on Bitcoin, USDT or TRX on TRON, USDC, USDT or SOL on Solana, and so on) pays straight into the wallet you saved for it, with Railbed's crypto fee taken from what arrives as on the other networks. You received shows the payment in dollars: USDC and USDT at face value, any other coin at the network's price when the payment was checked, with the amount of that coin beside it. The fee and wallet are locked when the buyer is shown the address, so removing or replacing the wallet stops new addresses for that network but doesn't move a payment already on its way. Keep access to the old wallet until those payments arrive.
Refunds and card disputes
Railbed has no refund control that reverses a settled payment; settled sales can't be pulled back from your wallet. A refund is something you arrange and send yourself. Recording a refund in WooCommerce doesn't send money. Card disputes are handled by the card provider; a payment status in Railbed is not a dispute-management service.
Establish what was paid and what arrived before deciding how to handle a customer's request. Deleting a checkout or canceling or voiding an invoice is never a refund.