01How the checkout fits in
- 01At checkout your backend creates an invoice for the order total with your order number as
referenceId. - 02You show the customer the deposit address and the network — or send them to the hosted payment page at
/pay/<checkoutId>— every invoice carries acheckoutId— which shows the amount, address and live status. - 03The customer pays. Payaries watches the address and moves the invoice through
pending,detected,confirmingandconfirmed. - 04Your webhook handler verifies the signature and marks the order paid.
POST /v1/invoices
{
"referenceId": "order_10231",
"fiat": { "amount": "49.99", "currency": "USD" },
"crypto": { "asset": "USDT_TRC20", "chainId": "tron-mainnet" }
}02What to know before you plan
- It's an API integration. There are no ready-made plugins for store platforms yet, so you'll write a small amount of backend code — the crypto payment API page shows it.
- Payments are irreversible. A refund is a separate transaction you send to the customer.
- Customers pay the network fee on their own transfer; choose networks your customers already use. Compare USDT on TRC-20, ERC-20 and BEP-20.
03Short, late and double payments
A short payment is flagged underpaid; a payment after expiry moves the invoice back to detected or underpaid; an amount that fits no invoice is recorded as an unclaimed deposit. Your order logic should handle each — see the guide.
Questions
- Is there a plugin for Shopify or WooCommerce?
- Not yet. Payaries is integrated through its REST API and Node SDK, so the store needs a small amount of backend code.
- Can customers pay without me building a checkout page?
- Yes. Every invoice carries a checkoutId that opens a shareable payment page showing the amount, deposit address and live status, so you can send customers there instead of building your own, and have them returned to your store afterwards with a success and cancel URL (see the hosted checkout guide).
- Who pays the network fee?
- The customer pays the network fee on their own transfer. Network fees on your withdrawals, and Payaries's own fees, are separate — ask sales@payaries.com for a quote.
Keep reading
- A crypto payment API that behaves like the rest of your stackA REST crypto payment API: create an invoice, get a one-time deposit address, receive signed webhooks and withdraw on demand. HMAC-signed and idempotent.
- Accept USDT payments on Ethereum, BNB Smart Chain, Polygon, Arbitrum, Tron and moreAccept USDT on Ethereum, BNB Smart Chain, Polygon, Arbitrum and Tron — and more networks as they ship — through one API, with a locked fiat rate and on-demand withdrawals.
- How a crypto payment gateway works, from invoice to settlementHow a crypto payment gateway works, step by step: invoices, one-time deposit addresses, confirmations, settlement and withdrawals.
- Crypto payment gateway vs just sharing a wallet addressDo you need a gateway, or can you just publish a wallet address? Compare attribution, rate lock, underpayments, webhooks and wallet control — and the volume where a gateway starts to pay off.
- A crypto payment gateway for Web3 companiesTake stablecoin and native-coin payments for your Web3 product through one API: dedicated wallets per network, signed webhooks, custom-token requests and on-demand withdrawals.
- Platform overviewWhat Payaries does and the chains it covers.
- Custom token payments: bring your own ERC-20, BEP-20 or TRC-20 tokenRequest your own ERC-20, BEP-20 or TRC-20 token on your Payaries account. How review works, and how invoices, fees and withdrawals work once it is approved.