Transaction webhooks are only available for ACH Transaction: Sale and Transaction: Refund requests.

Notification kinds

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

  • braintree.WebhookNotification.Kind.TransactionSettlementDeclined
  • braintree.WebhookNotification.Kind.TransactionSettled

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

Notification Type Description

Settlement for the transaction was declined.

May be triggered after the transaction_settled webhook if the customer's bank returns the refund after it has appeared to settle.


Transaction successfully settled.


kind enum

The kind of webhook notification.

timestamp date

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


A Transaction object.

The associated transaction.