FAQ

How long does an invoice stay valid?#

Default TTL is 30 minutes. You can override via ttl_minutes on POST /api/invoices (min 1, max 1440).

What happens if the buyer pays after expiry?#

The invoice transitions to invoice.late_payment. This is exceptional — treat it as a reconciliation case, not a fulfilment case.

Can I change the commission rate per invoice?#

No. Commission is set per merchant at onboarding. It's surfaced on every invoice as commission_amount for transparency.

Are webhooks retried automatically?#

Yes — failed deliveries are retried with exponential backoff (from ~30 seconds up to ~24 hours, 8 attempts total). After that the event is exhausted and you can redeliver it manually from the dashboard. See Delivery semantics.

Why was my webhook URL rejected when I saved it?#

The destination must be a public http(s) host: URLs with embedded credentials, or hostnames resolving to private/internal addresses (localhost, 10.x, 192.168.x, cloud-metadata ranges and similar) are refused for security reasons. For local development use a public tunnel such as ngrok or cloudflared.

What do I do if I rotated my webhook secret mid-flight?#

Any delivery dispatched before rotation was signed with the old secret. Options:

• Accept both old and new secrets during a grace window on your handler.
• Or: let those deliveries fail, then retry them from the dashboard after rotation — they'll be re-signed with the current secret.

Can I receive events for multiple merchants on one endpoint?#

Yes. Use the merchant_id field in the payload (or a merchant-specific path in your webhook URL) to route.

Which currencies and networks are supported?#

BTC, ETH, USDT, USDC, POD/xPOD, TAO and XMR across seven mainnet networks. The canonical, always-current matrix is rendered live from the /currencies endpoint in Payments & confirmations.

How do I test overpayment / underpayment?#

Use a dedicated test merchant and send a small real amount different from crypto_amount to the deposit address. The platform only runs on mainnet today — there is no testnet — so keep amounts minimal while you're verifying the flow.

Is there a sandbox or testnet environment?#

Not today. Every supported network is mainnet. Until a sandbox exists, integrate with a dedicated test merchant and minimal real amounts.

Where do I file bugs?#

Contact your account manager or file via the support path in your onboarding email.