Capture Binance Pay

Overview

After initializing a Binance Pay payment session, use this endpoint to capture the payment and generate the necessary payment links and QR codes for customer checkout.

Binance Pay transactions are processed in real-time. Once a customer completes payment, funds are settled instantly to your Binance account.

Capture Payment

POST /payment-sessions/{payment_id}

URL Parameters

payment_id

string

required

The unique identifier of the initialized payment session

Response Format

The capture response includes several options for completing payment:

links

object

Show Payment Links

checkout_url

string

Web-based checkout URL for desktop browsers

payment_url

string

Direct payment URL for mobile browsers

deeplink

string

Binance app deep link for mobile devices

qr_url

string

QR code image URL for scanning

Example Response

{
    "data": {
        "auth_type": null,
        "expires_at": "2024-04-09T01:11:30.239705Z",
        "links": {
            "checkout_url": "https://pay.binance.com/en/checkout/4d77d0ec555b4f608b268c122e8b6996",
            "deeplink": "bnc://app.binance.com/payment/secpay?tempToken=zMHCDA6mqNhTr2UW30K0eqimz3mvG1Lz",
            "payment_url": "https://app.binance.com/payment/secpay?linkToken=4d77d0ec555b4f608b268c122e8b6996",
            "qr_url": "https://public.bnbstatic.com/static/payment/20240408/1dc47f7c-84d7-46ce-b5e5-632414d65e3d.jpg"
        },
        "message": "Waiting for payment",
        "payment": {
            "amount": 100,
            "currency": "USD",
            "status": "pending",
            "customer": {
                "billing_address": {
                    "city": "Awolowo Road",
                    "country": "NG",
                    "line1": "Opposite Sasa Estate",
                    "line2": "null",
                    "state": "Kwara",
                    "zip_code": "23401"
                },
                "email": "asajuenitan@gmail.com",
                "first_name": "Enitan",
                "id": "d05e51df-809e-498a-ac3f-7acfc0b5d35d",
                "last_name": "Michael",
                "phone_number": "+2348036120313"
            },
            "date": "2024-04-08T13:11:30.207263Z",
            "description": "Deposit",
            "id": "83a6783c-f5a9-11ee-8831-feb7e1bada9f",
            "reference": "ref-juice-360e19cc-07ee-4d36-99e3-1744fb45de93"
            // Additional payment details omitted for brevity
        },
        "status": "pending"
    }
}

Payment Flow

Capture Payment

Make a POST request to the capture endpoint

Present Payment Options

Based on the customer’s device:

Mobile App Users: Use the deep link
Mobile Web: Use the payment URL
Desktop: Show QR code or checkout URL

Monitor Status

Track payment status through:

Webhooks (recommended)
Polling the payment status endpoint

Implementation Tips

Mobile Detection

function getBinancePayLink(links) {
  if (isNativeApp()) {
    return links.deeplink;
  } else if (isMobile()) {
    return links.payment_url;
  } else {
    return links.checkout_url;
  }
}

QR Code Display

function BinancePayQR({ qrUrl }) {
  return (
    <div className="qr-container">
      <img src={qrUrl} alt="Binance Pay QR Code" />
      <p>Scan with Binance App to pay</p>
    </div>
  );
}

Error Handling

payment_expired

error

Payment session has expired

Status code: 400
Create a new payment session

payment_cancelled

error

Customer cancelled the payment

Status code: 400
Handle gracefully in UI

Payment sessions expire after 30 minutes. Always check the expires_at timestamp and create a new session if needed.

Testing

In sandbox mode, Binance Pay uses real transactions. Use small amounts (e.g., 1 USD) for testing.

Best Practices

Device Detection
- Use deep links for mobile app users
- Show QR codes for desktop users
- Offer fallback options
Payment Monitoring
- Implement webhook handling
- Update UI based on payment status
- Handle timeouts gracefully
Error Handling
- Monitor session expiration
- Handle network errors
- Provide clear user feedback

Need Help?

For additional assistance:

Check our Webhooks Guide
Review Error Handling
Contact Support

On this page

Overview
Capture Payment
URL Parameters
Response Format
Example Response
Payment Flow
Implementation Tips
Error Handling
Testing
Best Practices

Overview

After initializing a Binance Pay payment session, use this endpoint to capture the payment and generate the necessary payment links and QR codes for customer checkout.

Binance Pay transactions are processed in real-time. Once a customer completes payment, funds are settled instantly to your Binance account.

Capture Payment

POST /payment-sessions/{payment_id}

URL Parameters

payment_id

string

required

The unique identifier of the initialized payment session

Response Format

The capture response includes several options for completing payment:

links

object

Show Payment Links

checkout_url

string

Web-based checkout URL for desktop browsers

payment_url

string

Direct payment URL for mobile browsers

deeplink

string

Binance app deep link for mobile devices

qr_url

string

QR code image URL for scanning

Example Response

{
    "data": {
        "auth_type": null,
        "expires_at": "2024-04-09T01:11:30.239705Z",
        "links": {
            "checkout_url": "https://pay.binance.com/en/checkout/4d77d0ec555b4f608b268c122e8b6996",
            "deeplink": "bnc://app.binance.com/payment/secpay?tempToken=zMHCDA6mqNhTr2UW30K0eqimz3mvG1Lz",
            "payment_url": "https://app.binance.com/payment/secpay?linkToken=4d77d0ec555b4f608b268c122e8b6996",
            "qr_url": "https://public.bnbstatic.com/static/payment/20240408/1dc47f7c-84d7-46ce-b5e5-632414d65e3d.jpg"
        },
        "message": "Waiting for payment",
        "payment": {
            "amount": 100,
            "currency": "USD",
            "status": "pending",
            "customer": {
                "billing_address": {
                    "city": "Awolowo Road",
                    "country": "NG",
                    "line1": "Opposite Sasa Estate",
                    "line2": "null",
                    "state": "Kwara",
                    "zip_code": "23401"
                },
                "email": "asajuenitan@gmail.com",
                "first_name": "Enitan",
                "id": "d05e51df-809e-498a-ac3f-7acfc0b5d35d",
                "last_name": "Michael",
                "phone_number": "+2348036120313"
            },
            "date": "2024-04-08T13:11:30.207263Z",
            "description": "Deposit",
            "id": "83a6783c-f5a9-11ee-8831-feb7e1bada9f",
            "reference": "ref-juice-360e19cc-07ee-4d36-99e3-1744fb45de93"
            // Additional payment details omitted for brevity
        },
        "status": "pending"
    }
}

Payment Flow

Capture Payment

Make a POST request to the capture endpoint

Present Payment Options

Based on the customer’s device:

Mobile App Users: Use the deep link
Mobile Web: Use the payment URL
Desktop: Show QR code or checkout URL

Monitor Status

Track payment status through:

Webhooks (recommended)
Polling the payment status endpoint

Implementation Tips

Mobile Detection

function getBinancePayLink(links) {
  if (isNativeApp()) {
    return links.deeplink;
  } else if (isMobile()) {
    return links.payment_url;
  } else {
    return links.checkout_url;
  }
}

QR Code Display

function BinancePayQR({ qrUrl }) {
  return (
    <div className="qr-container">
      <img src={qrUrl} alt="Binance Pay QR Code" />
      <p>Scan with Binance App to pay</p>
    </div>
  );
}

Error Handling

payment_expired

error

Payment session has expired

Status code: 400
Create a new payment session

payment_cancelled

error

Customer cancelled the payment

Status code: 400
Handle gracefully in UI

Payment sessions expire after 30 minutes. Always check the expires_at timestamp and create a new session if needed.

Testing

In sandbox mode, Binance Pay uses real transactions. Use small amounts (e.g., 1 USD) for testing.

Best Practices

Device Detection
- Use deep links for mobile app users
- Show QR codes for desktop users
- Offer fallback options
Payment Monitoring
- Implement webhook handling
- Update UI based on payment status
- Handle timeouts gracefully
Error Handling
- Monitor session expiration
- Handle network errors
- Provide clear user feedback

Need Help?

For additional assistance:

Check our Webhooks Guide
Review Error Handling
Contact Support

On this page

Overview
Capture Payment
URL Parameters
Response Format
Example Response
Payment Flow
Implementation Tips
Error Handling
Testing
Best Practices

Overview

Capture Payment

URL Parameters

Response Format

Example Response

Payment Flow

Implementation Tips

Error Handling

Testing

Best Practices

Need Help?

exchange

payouts

payments

Capture Binance Pay

Overview

Capture Payment

URL Parameters

Response Format

Example Response

Payment Flow

Implementation Tips

Error Handling

Testing

Best Practices

Need Help?

​Overview

​Capture Payment

​URL Parameters

​Response Format

​Example Response

​Payment Flow

​Implementation Tips

​Error Handling

​Testing

​Best Practices

Need Help?

exchange

payouts

payments

​Overview

​Capture Payment

​URL Parameters

​Response Format

​Example Response

​Payment Flow

​Implementation Tips

​Error Handling

​Testing

​Best Practices

Need Help?

Overview

Capture Payment

URL Parameters

Response Format

Example Response

Payment Flow

Implementation Tips

Error Handling

Testing

Best Practices

Overview

Capture Payment

URL Parameters

Response Format

Example Response

Payment Flow

Implementation Tips

Error Handling

Testing

Best Practices