Guides

Guides to accepting crypto payments

Plain-language explanations written from how a working payment gateway behaves — not from theory. Each one ends at something you can build or decide.

New to crypto? Start with the plain-English explainers on the blog.

Guides

  1. 01How 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.
  2. 02Crypto payment confirmations, explained for merchantsHow blockchain confirmations work for merchants: what each invoice status means, when a payment counts as paid, and credited vs withdrawable.
  3. 03Handling underpaid, late and unmatched crypto paymentsWhat to do when a customer underpays, pays after an invoice expires or sends money that matches no invoice — and how to build order logic for each.
  4. 04How to verify crypto payment webhook signaturesVerify a crypto payment webhook's HMAC-SHA256 signature against the raw body, guard against replays, dedupe retries and acknowledge fast — with working Node.js code.
  5. 05Managed vs self-held crypto payment gatewaysWhat managed and self-held payment gateways mean for control, speed and risk — and what to ask any provider about where your funds sit.
  6. 06Crypto payment API quickstart: from signup to your first payoutTake your first crypto payment through the Payaries API: create a key, submit the business profile, create an invoice, handle the webhook and withdraw. Real requests and responses.
  7. 07How to sign crypto payment API requests (HMAC-SHA256)How to sign Payaries API requests with HMAC-SHA256, with working Node.js, Python, Go and shell code and published test vectors to check your implementation against.
  8. 08Crypto payment API errors, rate limits and safe retriesEvery status code and error code the Payaries API returns, what each means, whether to retry it, the rate limits, and a retry loop that never double-pays.
  9. 09Withdrawing crypto through the API: quote, idempotency and approvalHow to withdraw crypto through the Payaries API: check the balance, quote the fees, create an idempotent withdrawal, follow its status and understand auto-approval.
  10. 10Hosted crypto checkout: send the customer, get them backUse Payaries's hosted payment page without building a checkout: create an invoice with a success and cancel URL, redirect the customer, verify the signed return and fulfil from the webhook.
  11. 11Accept crypto on Shopify without payments-partner approvalHow Payaries's Shopify connector works: a manual payment method or a cart-page button, the hosted pay page, how orders are marked paid, the order tags to watch, and the limits. Early access.

Build with Payaries

Comparisons

Next

Read it, then run it on a real invoice.

Test keys work immediately, with no approval step.