Braintree Auth is in closed beta. Contact us to express interest.

Notification kinds

The notification kind, returned by calling kind on the notification object, reveals what triggered the webhook. The webhook_notification.kind for Braintree Auth webhooks will be one of the following:

  • Braintree::WebhookNotification::Kind::ConnectedMerchantStatusTransitioned
  • Braintree::WebhookNotification::Kind::ConnectedMerchantPayPalStatusChanged

The following table describes the conditions that trigger each kind of webhook.

Notification Type Description

A connected merchant's underwriting status has changed or they have submitted an application.


A connected merchant's PayPal account has been successfully linked or unlinked to their Braintree gateway.


kind enum

The kind of webhook notification.

timestamp date

The UTC date/time at which the webhook was triggered.

merchant_id string

The ID of the connected merchant.

oauth_application_client_id string

The OAuth application client ID.

See the Braintree Auth webhooks guide for additional attributes specific to each webhook kind.