availability

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::TRANSACTION_SETTLEMENT_DECLINED
  • Braintree_WebhookNotification::TRANSACTION_SETTLED

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

Notification Type Description
transaction_settlement_declined

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_settled

Transaction successfully settled.

Attributes

kind enum

The kind of webhook notification.

timestamp date

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

transaction

A Transaction object.

The associated transaction.