Real-Time Reconciliation events for Stripe v2

Last updated
Save as PDF

The following table lists Zuora's actions on Stripe events when the Real-Time Gateway Reconciliation feature is enabled.

Stripe event type	Stripe object	Stripe event	Zuora's action
Payment	Payment Intent	amount_capturable_updated	N/A
		canceled	Zuora updates the Gateway State to "FailedToSettle" on the payment transaction. Zuora updates the gateway reconciliation status of the payment to “canceled”. Zuora updates the gateway reconciliation reason of the payment with the corresponding failure code and message. 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.
		created	N/A
		payment_failed	Zuora updates the Gateway State to "FailedToSettle" on the payment transaction. Zuora updates the gateway reconciliation status of the payment to “payment_failed”. Zuora updates the gateway reconciliation reason of the payment with the corresponding failure code and message. 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.
		processing	N/A
		requires_action	N/A
		succeeded	Zuora updates the Gateway State to "Settled" on the Payment transaction. Zuora updates the gateway reconciliation status of the payment to “succeeded”.
	Payout	created	The payment payout is mapped to the corresponding Payout ID.
	Dispute	closed (status = lost)	Zuora updates the Gateway State to "Settled" on the payment transaction. Zuora creates an external refund. Zuora updates the gateway reconciliation status of the payment to “charge.dispute.closed.lost”. Zuora updates the gateway reconciliation reason of the payment with the corresponding message.
Refund	Charge	refunds.data.status = failed	Zuora updates the Gateway State to "Reject" on the refund transaction.
		refunds.data.status = canceled	Zuora updates the Gateway State to "FailedToSettle" on the refund transaction and reverses the refund according to the global setting configured in the Gateway Reconciliation Configuration page in Zuora Payments Settings.
		refunds.data.status = pending	N/A
		refunds.data.status = succeeded	Zuora updates the Gateway State to "Settle" on the refund transaction.
	Payout	created	The refund payout is mapped to the corresponding Payout ID.
Mandate Only mandate update events of Credit Card and Credit Card Reference Transaction payment methods are supported.	Mandate	updated ( status = active)	Zuora updates the payment method status to “Active”. Zuora updates the mandate status of the payment method to "active". The mandate reason is empty.
		updated ( status = inactive)	Zuora updates the payment method status to “Closed”. Zuora updates the mandate status of the payment method to "inactive". The mandate reason is empty.
		updated ( status = pending)	Zuora updates the mandate status of the payment method to "Closed". The mandate reason is empty.

For more information about how to enable the Real-Time Reconciliation feature, see Configure Real-Time Reconciliation for Stripe v2.