Webhooks

Payment Method

Notification kindsAnchorIcon

The notification kind, returned by calling kind on the notification object, reveals what triggered the webhook. The $webhookNotification->kind for Payment Method webhooks will be one of the following:
  • BraintreeWebhookNotification::PAYMENTMETHODREVOKEDBYCUSTOMER
  • BraintreeWebhookNotification::PAYMENTMETHODCUSTOMERDATAUPDATED

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

Notification Type Description
payment_method_revoked_by_customer A payment instrument that was previously enabled has been revoked by the customer or by Venmo.
Currently this webhook will only be sent when a customer cancels their PayPal billing agreement, removes their Venmo connection , or when Venmo suspends the account due to suspicious activity on the customer's Venmo account.
payment_method_customer_data_updated A payment method's customer data has been updated. Currently, the only trigger for this webhook is when a customer updates their Enriched Customer Data in Venmo, provided that the merchant has enabled the feature.

AttributesAnchorIcon

kindenum
The kind of webhook notification.
timestampdate
The UTC time at which the webhook was triggered.
revokedPaymentMethodMetadata

Metadata referencing the revoked payment method.

tokenstring
An alphanumeric value that references a specific payment method stored in your Vault (used for recurring purchases).
customerIdstring
A value representing an existing customer stored in your Vault. Use Customer: Find call to look up a single customer.
revokedPaymentMethod
The PaymentMethod object associated with the revoked payment method.
paymentMethodCustomerDataUpdatedMetadata

Metadata referencing the payment method whose customer data was updated.

tokenstring
An alphanumeric value that references a specific payment method stored in your Vault (used for recurring purchases).
paymentMethod
The payment method including the customer data that was updated.
datetimeUpdatedstring
Timestamp of the customer data update.
enrichedCustomerData
Collection of fields encompassing the Enriched Customer Data feature.
profileData
Collection of fields encompassing the customer's profile data.
usernamestring
The customer's Venmo username.
firstNamestring
The customer's first name.
lastNamestring
The customer's last name.
phoneNumberstring
The customer's phone number.
emailstring
The customer's email.
billingAddress
Collection of fields encompassing the customer's billing address.
streetAddressstring
The billing address building number and street name.
extendedAddressstring
The billing address additional information.
localitystring
The billing address locality.
regionstring
The billing address region.
postalCodestring
The billing address postal code.
shippingAddress
Collection of fields encompassing the customer's shipping address.
streetAddressstring
The shipping address building number and street name.
extendedAddressstring
The shipping address additional information.
localitystring
The shipping address locality.
regionstring
The shipping address region.
postalCodestring
The shipping address postal code.
fieldsUpdatedArray
Array containing which fields from the data collection were updated, triggering the webhook.

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more