Skip to main content

Real-Time Reconciliation events for Braintree v2.0

Zuora

Real-Time Reconciliation events for Braintree v2.0

Zuora supports the following event types for Real-Time Reconciliation on Braintree v2.0:

Braintree object Braintree event Zuora action
Payment transaction_settled
  • Zuora updates the Gateway State field to Settled on the payment transaction.
  • No value is populated in the Gateway Reconciliation Status or Gateway Reconciliation Reason field.
dispute_lost
  • Zuora updates the Gateway State field to Settled on the payment transaction.
  • By default, Zuora creates an external refund. If the Payment Reversal code is active in the Reason Codes list, the reason code is set to Payment Reversal. Otherwise, the reason code is set to the default reason code in the list. If you want to opt out of this default behavior and disable the generation of external refunds for dispute events, submit a request at Zuora Global Support.
  • No value is populated in the Gateway Reconciliation Status or Gateway Reconciliation Reason field.
transaction_settlement_declined
  • Zuora updates the Gateway State field to FailedToSettle on the payment transaction. The Gateway Reconciliation Reason field is populated with the reason information but the Gateway Reconciliation Status field is not populated.
  • Zuora creates an external refund with the reason code set to Payment Rejection if the code is active in the Reason Codes list. Otherwise, Zuora creates an external refund with the reason code set to the default reason code in the list.
  • If the Support refunding payments from the credit balance with Gateway Reconciliation setting is enabled, a credit balance refund will be created. See Refund payments with credit balance in gateway reconciliation for more information.
Refund transaction_settled Zuora updates the Gateway State field to Settled on the refund transaction. No value is populated in the Gateway Reconciliation Status or Gateway Reconciliation Reason field.
transaction_settlement_declined Zuora updates the Gateway State field to FailedToSettle on the refund transaction and reverses the refund according to the global setting configured on the Gateway Reconciliation Configuration page in Zuora Payments settings. No value is populated in the Gateway Reconciliation Status or Gateway Reconciliation Reason field.
PayPal payment_revoked_by_customer Zuora closes the PayPal payment method.