The pay-by-mail flow
- The buyer clicks the Coin Moebius button on your site and picks "Pay by mail" in the payment popup. They see a preview first: your mailing address, the amount due, and any instructions you set, with a <strong>"Confirm, I'll send payment"</strong> button. Nothing is recorded yet, and there is no reference code at this stage.
- The buyer clicks "Confirm, I'll send payment." That is the step that creates the transaction: Coin Moebius generates a unique reference code like
X2M-K9P-R7QWand shows it alongside your mailing address. The buyer puts the reference code inside the package or on the check. - Once they confirm, a row appears in your dashboard's Transactions tab with status Awaiting mail. A button above the list counts the orders awaiting mail, and clicking it shows only those rows.
- When the buyer's payment arrives in your mailbox (cash, check, Goldback, whatever the expected currency was), type the reference code into the search box on the Transactions tab to find the matching row. Open the row's menu and choose Mark received. If the buyer left an email address at checkout, we send them a receipt, and you proceed to ship whatever they bought.
- If the buyer's payment never arrives, the row auto-expires after 30 days. You can also choose Cancel payment on a row before that.
- If you confirmed receipt but later discover the payment was invalid (counterfeit, wrong item, empty envelope), choose Reverse payment from the row's menu. The status changes to Reversed. This corrects your records in the dashboard. Communicating with the buyer about what happened next is between you and them.
Testing pay-by-mail
Pay-by-mail has no sandbox, no test keys, and no external account to configure. The entire flow happens between your site and your dashboard. There are two ways to test it: the full round trip from a buy button on a page, or a quick test straight from the dashboard.
Quick test from the dashboard
The dashboard can make a pay-by-mail test order without a buy button on a page. This is useful for seeing what a transaction row looks like and practicing the "Mark received" flow.
- Open Payment methods on your store, open the menu on the Pay by mail row, and choose Run a test payment.
- Click Make test checkout. A reference code appears, the same kind a buyer gets.
- Open Transactions and turn on Show test payments. The new row is there, tagged "Test" so it doesn't mix with live data.
The test row is an Awaiting mail row with a real reference code. You can then practice "Mark received," "Cancel payment," and "Reverse payment" from its menu.
Test checkouts have no Coin Moebius fee and don’t use your included sales.
Full round trip from a buy button
To test the complete flow (what your buyer sees through what you see), walk through these steps. The whole thing takes about two minutes.
- Set up the provider. In your dashboard, open Providers, click Connect a provider, and pick Pay by mail. Enter any mailing address (your own is fine for testing). Save.
- Add a product. In the Products tab, create a product with a name like "Test item", a price, and a currency.
- Put the buy button on a page. Paste the buy button HTML on any page, even a bare HTML file on your computer.
- Click the button and pick "Pay by mail." The payment popup opens showing every provider you've connected. Pick "Pay by mail." You'll see a preview with your mailing address, the expected amount and currency, and a "Confirm, I'll send payment" button. No reference code yet.
- Click "Confirm, I'll send payment." This is the buyer committing to send payment. Coin Moebius records the transaction and shows a reference code like
X2M-K9P-R7QW. - Open the dashboard. Go to the Transactions tab. A new row appears with status Awaiting mail and the same reference code you just saw. A button above the list counts the orders awaiting mail.
- Choose "Mark received" from the row's menu. The row's status changes to Paid. That's the complete happy path, from the buyer's click to your confirmation.
Finding a transaction by reference code
When a payment arrives in your mailbox, look for the reference code the buyer included (printed on the envelope, written on the check memo, or tucked inside the package). Then type that code into the search box on the Transactions tab. The table filters to matching rows as you type, so you can choose "Mark received" on the right one without paging through your full transaction history.
Testing the other outcomes
Run through the same steps again, but instead of marking the row received, try each of these:
- Cancel it. Choose "Cancel payment" from the pending row's menu. The status changes to Canceled. This is what you'd do when a buyer tells you they changed their mind before mailing anything.
- Let it expire. Leave a pending row alone. After 30 days it auto-expires to Expired. You don't need to wait 30 days to verify the behavior. Expiration works the same as Cancel payment, except it happens automatically on a schedule.
- Record a different amount. "Mark received" confirms the order at the amount the buyer was shown, and it has no amount field. If something else arrived (e.g., the buyer sent 4 Goldbacks instead of 5), choose "Add note" on the row and write down what actually came.
- Reverse a confirmation. First mark a row received so it shows Paid, then choose "Reverse payment" from that row's menu. The status changes to Reversed. This is how you'd correct a mistake or flag a payment that turned out to be invalid after the fact.
What to look for
- The reference code in the payment popup matches the reference code on the dashboard row.
- Your mailing address displays correctly in the payment popup.
- The "Mark received" and "Cancel payment" menu items appear only on Awaiting mail rows, not on card or crypto transactions.
- After marking received, the row shows Paid with the correct amount.
- Searching by reference code in the search box finds the right row.
For card payments, use your provider’s test setup with a product in testing mode. For supported crypto methods and payment by mail, choose “Run a test payment” from the payment method’s menu. We don’t charge for these test checkouts or count them toward your included sales. Tests using real money or coins can still carry provider or network fees. A purchase created as a live checkout is a real sale, even if you make it yourself. On Flex, the usual 2% + 20¢ applies.