home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Enable and configure Real-Time Reconciliation for Braintree v2.0

Real-Time Reconciliation events for Braintree v2.0

Zuora supports various event types for Real-Time Reconciliation on Braintree v2.0, including payment and refund transactions, with specific actions for each event type.

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.

Last updated: January 15, 2026