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.