General/
Webhooks/
OAuth

OAuth

Notification kindsAnchorIcon

The notification kind, returned by calling kind on the notification object, reveals what triggered the webhook. The webhook_notification.kind for OAuth webhooks will be one of the following:
  • braintree.WebhookNotification.Kind.OAuthAccessRevoked

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

Notification TypeDescription
oauth_access_revocation

A connected merchant has revoked API access.

AttributesAnchorIcon

kindenum
The kind of webhook notification.
timestampdate
The UTC time at which the webhook was triggered.
merchant_idstring
The ID of the connected merchant.
oauth_application_client_idstring
The OAuth application client ID.

OAuth access revokedAnchorIcon

Below is a full example of how to trigger a webhook when a connected merchant has revoked access to their account.

  1. Python
gateway = braintree.BraintreeGateway(
  braintree.Configuration(
    environment=braintree.Environment.Sandbox
    merchant_id='use_your_merchant_id',
    public_key='use_your_public_key',
    private_key='use_your_private_key',
  )
)

notification = gateway.webhook_notification.parse(
  bt_signature,
  bt_payload
)

notification.kind
# braintree.WebhookNotification.Kind.OAuthAccessRevoked

notification.oauth_access_revocation.merchant_id
# "merchant_id"