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