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:

  • BraintreeWebhookNotification::TRANSACTION_SETTLEMENT_DECLINED
  • BraintreeWebhookNotification::TRANSACTION_SETTLED

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.