Binance Pay

Let customers pay from their Binance account.

Open the interactive version or read this guide as markdown.

API reference

• POST /api/v1/payments: Create a payment
• POST /api/v1/payments/{reference}/pay-with-exchange: Create a Binance Pay link

Binance Pay lets your customers pay from their Binance account. You get the same payment webhooks as any other crypto payment.

On the checkout page

Binance Pay is on the checkout page, with nothing to set up.

1. Your customer picks a token and blockchain, e.g. USDT on Tron.
2. They select Pay with Binance.
3. On a computer, the page shows a QR code to scan with the Binance app. On a phone, Binance opens with the payment ready to confirm.
4. The page shows when the payment arrives.

In your own checkout

How it works

1. Create a payment with POST /api/v1/payments, with the token and blockchain your customer picked.
2. Request a Binance Pay link with POST /api/v1/payments/{reference}/pay-with-exchange.
3. Open the link on a phone, or show it as a QR code on a computer.
4. Wait for the payment.completed webhook.

If the payment was created without a token and blockchain, generate its deposit address with POST /api/v1/payments/{reference}/address before requesting the link.

Request the link

POST https://api.coincircuit.io/api/v1/payments/cs-7f3a9c1e5b2d4f8a6c0e9b1d3a5f7c2e/pay-with-exchange

{
  "paymentMethod": "binance_pay_onchain"
}

The response:

{
  "success": true,
  "message": "Exchange payment initiated",
  "data": {
    "sessionReference": "cs-7f3a9c1e5b2d4f8a6c0e9b1d3a5f7c2e",
    "paymentMethod": "binance_pay_onchain",
    "amount": "250.00000000",
    "asset": "USDT",
    "chain": "tron",
    "link": "https://app.binance.com/uni-qr/qccnt?amount=250&cryptoCurrency=USDT&externalOrderId=3f9c2b7e4d1a4c0f9b8e7d6c5b4a3f2e&merchantCode=coincircuit&sign=a6fdb970954b3407e63c2518307bd42b8b1de3fb128914a9f5b926077efcec5f",
    "expiresAt": "2026-10-13T15:42:00.000Z"
  }
}

Errors