Binance · AsyncAPI Specification

Binance Pay Webhooks

Version 1.0.0

Binance Pay sends webhook notifications to merchants for real-time payment status updates. When a customer completes a payment or a refund is processed, Binance Pay sends an HTTPS POST request to the merchant's configured webhook URL with event details.

View Spec View on GitHub CryptocurrencyExchangeTradingBlockchainFinanceDeFiMarket DataAsyncAPIWebhooksEvents

Channels

/webhook
publish receivePaymentNotification
Receive payment event notifications
Webhook endpoint that receives Binance Pay event notifications. Merchants must verify the signature header to authenticate webhook requests.

Messages

PaymentSuccess
Payment Success
Notification sent when a customer successfully completes a payment.
PaymentCanceled
Payment Canceled
Notification sent when a payment is canceled.
PaymentExpired
Payment Expired
Notification sent when a payment order expires.
RefundSuccess
Refund Success
Notification sent when a refund is successfully processed.

Servers

https
merchantWebhook {merchantWebhookUrl}
Merchant-configured webhook endpoint that receives payment notifications from Binance Pay.