Braintree Webhooks deliver automated HTTP POST notifications to your server when specific events occur within the payment gateway. Supported event types include subscription status changes, transaction settlements, disbursements, dispute openings and resolutions, and sub-merchant account status updates for Braintree Marketplace. Each webhook notification contains the event kind and the full Braintree object associated with the triggering event.
Braintree Webhooks is one of 14 APIs that Braintree publishes on the APIs.io network, described by an AsyncAPI event-driven specification.
Tagged areas include Disputes, Event, Notification, Subscription, and Webhook. The published artifact set on APIs.io includes API documentation and an AsyncAPI specification.
This event API exposes
1 operation
across 1 channel,
and defines 30 schemas.
It is described by AsyncAPI 2.6.0, at version 1.0.
The API connects through a single server, {webhookDestinationUrl} (https).
1 operations1 channels30 schemas
Metadata
The identity and technical contract details declared by the specification.
Across 1 channel, the API surfaces 1 operation. Each is listed below with its action, channel, parameters, and response codes.
Channels 1
PUB
/webhook
Receive a Braintree webhook notification
receiveBraintreeWebhookbody
Messages & Schemas 30
The contract defines 30 schemas that model the data carried by its messages. The most detailed are WebhookNotification (2 properties), WebhookFormPayload (2 properties), WebhookHeaders (1 property). Each schema is shown below with its type and property counts.
SubscriptionChargedSuccessfully
message
A subscription billing cycle completed with a successful charge.
SubscriptionChargedUnsuccessfully
message
A subscription billing cycle charge attempt failed.
SubscriptionWentActive
message
A subscription transitioned to Active status.
SubscriptionWentPastDue
message
A subscription transitioned from Active to Past Due status.
SubscriptionExpired
message
A subscription reached its configured number of billing cycles.
SubscriptionCanceled
message
A subscription was canceled.
SubscriptionTrialEnded
message
A subscription's trial period ended.
SubscriptionBillingSkipped
message
A subscription billing cycle was skipped due to a zero or negative balance.
TransactionSettled
message
A transaction settled successfully.
TransactionSettlementDeclined
message
Settlement for a transaction was declined.
DisputeOpened
message
A new dispute was opened against a transaction.
DisputeWon
message
A dispute was resolved in the merchant's favor.
DisputeLost
message
A dispute was resolved in the cardholder's favor.
DisputeAccepted
message
A dispute was accepted by the merchant.
DisputeAutoAccepted
message
A dispute was automatically accepted after the reply deadline passed.
DisputeDisputed
message
Evidence was submitted and the dispute is under review.
DisputeExpired
message
A dispute expired without resolution.
DisputeUnderReview
message
A dispute is under internal review with PayPal.
Disbursement
message
Funds were disbursed to the merchant's bank account.
TransactionDisbursed
message
A transaction was marked for disbursement. Deprecated in favor of the Disbursement event.
SubMerchantAccountApproved
message
A Braintree Marketplace sub-merchant account was approved.
SubMerchantAccountDeclined
message
A Braintree Marketplace sub-merchant account application was declined.
WebhookHeaders
object
HTTP headers included in webhook POST requests from Braintree.
1 property
WebhookFormPayload
object
The form-encoded body of all Braintree webhook HTTP POST requests. Merchants use a Braintree server SDK to parse and verify the payload.
2 properties2 required
WebhookNotification
object
The parsed webhook notification object returned by the Braintree server SDK after verifying and decoding the btpayload.
2 properties2 required
SubscriptionNotificationPayload
object
Webhook payload for subscription lifecycle events. The parsed notification contains a subscription object with up to 20 recent associated transactions.
TransactionNotificationPayload
object
Webhook payload for transaction settlement events. The parsed notification contains the full transaction object including current status, amounts, and settleme…
DisputeNotificationPayload
object
Webhook payload for dispute lifecycle events. The parsed notification contains the dispute object with the associated transaction, disputed amount, reason code…
DisbursementNotificationPayload
object
Webhook payload for disbursement events. The parsed notification contains a disbursement object with the total amount disbursed and the list of associated tran…
MerchantAccountNotificationPayload
object
Webhook payload for sub-merchant account status events. The parsed notification contains the merchant account object for the sub-merchant including approval st…
Specification
The full machine-readable AsyncAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Braintree Webhooks, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
