Notification kinds

The notification kind, returned by calling kind on the notification object, reveals what triggered the webhook. The $webhookNotification->kind for Grant API webhooks will be one of the following:

  • Braintree_WebhookNotification::GRANTED_PAYMENT_INSTRUMENT_UPDATE

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

Notification Type Description

A payment instrument that was previously granted to another Braintree merchant has been updated.


kind enum

The kind of webhook notification.

timestamp date

The UTC time at which the webhook was triggered.

grantOwnerMerchantId string

The merchant ID of the Braintree merchant that owns the payment instrument.

grantRecipientMerchantId string

The merchant ID of the Braintree merchant that was granted the payment instrument.

paymentMethodNonce object

An object containing the payment method nonce, which represents the updated payment instrument.

nonce string

A payment method nonce representing the updated payment instrument.

consumed boolean

A value that indicates if the payment method nonce has been used.

updatedFields Array

An array of strings denoting all of the fields of the payment instrument that were updated.

See the Grant API webhooks guide for additional attributes specific to each webhook kind.

Still have questions?

If you can’t find an answer, contact our Support team