Payment Gateways (Cryptomus & OxaPay)
Accept crypto payments through your preferred processor
Shoplio supports two crypto payment gateways: Cryptomus and OxaPay. Choose one per shop in Settings > Payments. New shops start on OxaPay. You do not need an account with either gateway: crypto payments go to the platform's gateway wallets and are credited to your shop balance. Card payments work differently; see Card Payments (ServerSide).
How a payment works
- When a customer checks out, Shoplio creates an invoice on your shop's gateway for the order total in USD. It is valid for 60 minutes.
- On Cryptomus, the invoice is for the coin the customer selected in your store. On OxaPay, the customer picks the coin and network on OxaPay's payment page.
- The gateway confirms the payment with a signed webhook. A poller also checks open invoices, so a confirmation is not lost if a webhook fails.
- The order is marked paid and the product is delivered automatically.
What gets credited: the amount the gateway actually delivers, net of the gateway's own commission, on both gateways. For OxaPay that commission is an estimated 1.5% on orders created after 2 July 2026. Shoplio itself charges no fee per order; its fee is taken at withdrawal (5% on Free, 3% on Pro and Enterprise).
Payment outcomes
- Paid: delivered automatically.
- Underpaid: the customer sent less than the invoice. Nothing is delivered automatically; you can decide to deliver it by hand from Orders.
- Expired: the invoice was not paid in time. Nothing is delivered and no stock is used.
- Paid but out of stock: the order waits until you restock and press Process, or until it is refunded to store balance if you allow that.
Switching gateways: change the selection in Settings > Payments. New invoices use the new gateway; balances already earned stay on the gateway that received them and are withdrawn from there. Checkout is never switched automatically, so if your gateway has an outage, switching is how you keep selling.
Which to choose: the dashboard describes Cryptomus as an established processor with wide network support and OxaPay as having lower minimum payments. XRP can only be accepted on OxaPay shops.
Common problems
- "Selected cryptocurrency is not available for this store's payment method": that coin is not supported on the shop's gateway.
- "Invalid cryptocurrency selected": the coin is not in the shop's accepted list.