The merchant's webhook endpoint that receives HTTP POST notifications from Braintree. All event types are delivered to the same configured URL. The bt_payload contains a Base64-encoded, signed XML document with the event details. Merchants must verify the bt_signature against the payload using their private API key before processing.
A subscription billing cycle completed with a successful charge.
Content-Type: application/x-www-form-urlencoded
subscription_charged_unsuccessfully
A subscription billing cycle charge attempt failed.
Content-Type: application/x-www-form-urlencoded
subscription_went_active
A subscription transitioned to Active status.
Content-Type: application/x-www-form-urlencoded
subscription_went_past_due
A subscription transitioned from Active to Past Due status.
Content-Type: application/x-www-form-urlencoded
subscription_expired
A subscription reached its configured number of billing cycles.
Content-Type: application/x-www-form-urlencoded
subscription_canceled
A subscription was canceled.
Content-Type: application/x-www-form-urlencoded
subscription_trial_ended
A subscription's trial period ended.
Content-Type: application/x-www-form-urlencoded
subscription_billing_skipped
A subscription billing cycle was skipped due to a zero or negative balance.
Content-Type: application/x-www-form-urlencoded
transaction_settled
A transaction settled successfully.
Content-Type: application/x-www-form-urlencoded
transaction_settlement_declined
Settlement for a transaction was declined.
Content-Type: application/x-www-form-urlencoded
dispute_opened
A new dispute was opened against a transaction.
Content-Type: application/x-www-form-urlencoded
dispute_won
A dispute was resolved in the merchant's favor.
Content-Type: application/x-www-form-urlencoded
dispute_lost
A dispute was resolved in the cardholder's favor.
Content-Type: application/x-www-form-urlencoded
dispute_accepted
A dispute was accepted by the merchant.
Content-Type: application/x-www-form-urlencoded
dispute_auto_accepted
A dispute was automatically accepted after the reply deadline passed.
Content-Type: application/x-www-form-urlencoded
dispute_disputed
Evidence was submitted and the dispute is under review.
Content-Type: application/x-www-form-urlencoded
dispute_expired
A dispute expired without resolution.
Content-Type: application/x-www-form-urlencoded
dispute_under_review
A dispute is under internal review with PayPal.
Content-Type: application/x-www-form-urlencoded
disbursement
Funds were disbursed to the merchant's bank account.
Content-Type: application/x-www-form-urlencoded
transaction_disbursed
A transaction was marked for disbursement. Deprecated in favor of the Disbursement event.
Content-Type: application/x-www-form-urlencoded
sub_merchant_account_approved
A Braintree Marketplace sub-merchant account was approved.
Content-Type: application/x-www-form-urlencoded
sub_merchant_account_declined
A Braintree Marketplace sub-merchant account application was declined.
Content-Type: application/x-www-form-urlencoded
About AsyncAPI
The AsyncAPI specification describes event-driven APIs the way OpenAPI describes request/response APIs. A channel is the named pipe — a webhook URL, a Kafka topic, a WebSocket route, an MQTT subject — that producers and consumers publish or subscribe to. Each channel carries one or more messages with structured payloads, and an operation declares whether a given party sends or receives on that channel.