​
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

​
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

1

Capture Payment

Make a POST request to the capture endpoint

2

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
3

Monitor Status

Track payment status through:

  1. Webhooks (recommended)
  2. Polling the payment status endpoint

​
Implementation Tips

​
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

  1. Device Detection

    • Use deep links for mobile app users
    • Show QR codes for desktop users
    • Offer fallback options

  2. Payment Monitoring

    • Implement webhook handling
    • Update UI based on payment status
    • Handle timeouts gracefully

  3. Error Handling

    • Monitor session expiration
    • Handle network errors
    • Provide clear user feedback

Need Help?

For additional assistance: