Quick Integration Guide

Connect stablecoin payments (USDT / USDC) in four steps. Configure an API Key, Webhook secret and receiving wallets for enabled networks first. The example on the right checks your API Key.

1

Create a payment order

Your backend

Call /api/v1/order/create from your backend with the price, currency, network and merchant order ID. The response contains your configured wallet and the final payable amount; multiple orders may share the same wallet.

GET /api/v1/ping checks your API Key. Creating an order also requires a timestamp and request signature.
2

Display payment details

Your frontend

Open checkoutUrl from the response, or display the amount, address, network and currency from payment. Funds go directly to your configured wallet.

Use the complete payment.amount. payment.qrData contains QR data, not an image.
3

Wait for payment confirmation

BoltUtil

BoltUtil matches transfers by network, currency, wallet and amount, then sends a notification to the associated notifyUrl when confirmation requirements are met. Eligible payment exceptions require merchant review.

Confirmation and delivery depend on blockchain and network conditions. A page redirect does not prove payment.
4

Verify and fulfill

Your backend

Verify the signature against the raw body, check the timestamp and associate the event with your order. Handle payable and paid amounts alongside the settlement type. Return HTTP 2xx after durable acceptance and fulfill idempotently.

Deduplicate by eventId and prevent repeated fulfillment of the business order. Manually accepted underpayments may have a paid amount below the payable amount.

Networks and Currencies

Check supported currencies, token versions and payment confirmation rules.

View supported networks →