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 webhook_notification.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.