Skip to content
Crypto Merchant

Basics

Checkout

Customers pay on pages hosted by Crypto Merchant. You don't need a website: share your checkout page or a payment link. If you do have one, create invoices with the API and send customers to the invoice page.

Your checkout page

Every store gets its own checkout page at /pay/<store>, where <store> is your store's short name. Customers can enter an amount there, or choose one of your payment links. Share it anywhere you talk to customers: your website, social profiles, chats or emails.

You'll find the link in the portal under Your checkout page.

The invoice page

Every invoice has its own page at /pay/i/<invoice_id>. The API returns this link as checkout_url. On it, the customer:

  • picks a coin and network from the ones you accept;
  • sees a deposit address made for this invoice, with a QR code, and the exact amount to send, at an exchange rate locked at that moment;
  • can switch to another coin until a payment is detected;
  • watches the status change live, from waiting to confirming to paid.

Each invoice is open for a limited time, shown as a countdown. If the time runs out before any payment is seen, the invoice expires. If you set a redirect_url, the customer can return to your site after paying.

If a customer paid but the payment didn't show up before the invoice expired, they can report it from the invoice page. The address is then taken out of rotation and kept under watch, and our support team checks the payment.

A payment link is a reusable link for one product, service or donation, at /pay/l/<link_id>. Give it a title and either a fixed amount, or leave the amount empty so the customer enters it. Every payment made through a link becomes its own invoice.

Create links in the portal under Payment links, or with the API.

Exchange rates

Invoices are priced in a currency such as US dollars. When the customer picks a coin, the amount in that coin is calculated from live prices and locked. Stablecoins such as USDT and USDC count as one US dollar each. If the payment is first seen while the invoice is still open, the locked rate applies.

Underpaid invoices

You set an underpayment tolerance in your settings; we recommend at least $1. If a confirmed payment is short by no more than the tolerance, the invoice counts as paid.

If the payment is short by more than that, the invoice becomes underpaid. What was sent is held for the customer, who can either send the rest to the same address or get a refund of what they sent to an address they enter. The network fee for a refund is taken from the refund.

Overpaid invoices

If a customer sends more than the invoice asks for, the invoice still counts as paid. What happens to the extra depends on its value:

  • More than $5: the customer can withdraw the extra to their own wallet from the invoice page.
  • $5 or less: it goes to the Crypto Merchant platform pool and is not returned.

Fees

1% of each paid invoice is deducted when the payment is credited to your balance. Expired and cancelled invoices cost nothing.