Real-Time Reconciliation events for Adyen v2.0

Real-Time Reconciliation events for Adyen v2.0

Last updated
Save as PDF

To review the final status of the payment, utilize the legacy Batch Gateway Reconciliation.

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

Payment

Adyen Object	Adyen Event	Zuora GR Event	Action on the Gateway state
Payment	CAPTURE + “success” : true	TransactionSettled	Zuora updates the Gateway State field to Settled on the payment transaction. Zuora updates Gateway Reconciliation Status to COMPLETED and populates Gateway Reconciliation Reason. Note: Applies only for Delayed Capture enabled merchant accounts when processing a separate capture.
	CAPTURE + “success” : false	TransactionRejected	Zuora updates the Gateway State field to FailedToSettle on the payment transaction. Gateway Reconciliation Reason is populated with the reason information and Gateway Reconciliation Status is set to DECLINED or DENIED. 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. Note: Applies only for Delayed Capture enabled merchant accounts when processing a separate capture.
	CANCELLATION + “success” : true	TransactionRejected	Zuora updates the Gateway State field to FailedToSettle on the payment transaction. Gateway Reconciliation Reason is populated with the reason information and Gateway Reconciliation Status is set to DECLINED or DENIED. 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. Note: Applies only for Delayed Capture enabled merchant accounts when processing a separate capture.
	AUTHORISATION + “success” : false	TransactionRejected	Zuora updates the Gateway State field to FailedToSettle on the payment transaction. Gateway Reconciliation Reason is populated with the reason information and Gateway Reconciliation Status is set to DECLINED or DENIED. 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.
	CANCELLATION + “success” : false	NA	NA
	AUTHORISATION + “success” : true	TransactionSettled	Zuora updates the Gateway State field to Settled on the payment transaction. Zuora updates Gateway Reconciliation Status to COMPLETED and populates Gateway Reconciliation Reason. Applies only when Delayed Capture is disabled.
	AUTHORISATION + “success” : true	NA	This applies to all payment attempts; however, it is not the final state when Delayed Capture is enabled. In those cases, the CAPTURE and CAPTURE_FAILED events become the final state events. Note: Applies only when Delayed Capture is enabled.
	CAPTURE_FAILED + “success” : true	TransactionRejected	Zuora updates the Gateway State field to FailedToSettle on the payment transaction. Gateway Reconciliation Reason is populated with the reason information and Gateway Reconciliation Status is set to DECLINED or DENIED. 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. Note: Applies only for Delayed Capture enabled merchant accounts when processing a separate capture.
	CAPTURE_FAILED + “success” : false	NA	Applies only for Delayed Capture enabled merchant accounts when processing a separate capture.

Chargeback

Adyen Object	Adyen Event	Zuora GR Event	Action on the Gateway state
Chargeback	NOTIFICATION_OF_FRAUD	NA	NA
	NOTIFICATION_OF_CHARGEBACK	NA	NA
	CHARGEBACK	TransactionReversed	Zuora updates the Gateway State field to Settled on the payment transaction. By default, Zuora creates an external refund. If "Payment Reversal" 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. Zuora updates the gateway reconciliation status of the payment to the Reason from the Chargeback Reason Code. Zuora updates the gateway reconciliation reason of the payment with the corresponding message.
	CHARGEBACK_REVERSED	NA	CHARGEBACK_REVERSED will not be a final state and enables the triggering of a potential SECOND_CHARGEBACK notification. Zuora does not take any action on the second chargeback as the balance is already reopened.
	SECOND_CHARGEBACK	NA	NA

Refund

Adyen Object	Adyen Event	Zuora GR Event	Action on the Gateway state
Refund	REFUND + "success" : true	TransactionSettle	Zuora updates the Gateway State field to Settled on the payment transaction. Zuora updates Gateway Reconciliation Status to COMPLETED and populates Gateway Reconciliation Reason.
	REFUND + "success" : false	TransactionRejected	Zuora updates the Gateway State field to FailedToSettle on the payment transaction. Gateway Reconciliation Reason is populated with the reason information and Gateway Reconciliation Status is set to DECLINED or DENIED. 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_FAILED + "success" : true	TransactionRejected
	REFUND_REVERSED + "success" : true	TransactionRejected
	REFUND_WITH_DATA + "success" : true	TransactionSettle	Zuora updates the Gateway State field to Settled on the payment transaction. Zuora updates Gateway Reconciliation Status to COMPLETED and populates Gateway Reconciliation Reason.
	REFUND_WITH_DATA + "success" : false	TransactionRejected	Zuora updates the Gateway State field to FailedToSettle on the payment transaction. Gateway Reconciliation Reason is populated with the reason information and Gateway Reconciliation Status is set to DECLINED or DENIED. 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.
	CANCEL_OR_REFUND + "success" : true	TransactionSettle	Zuora updates the Gateway State field to Settled on the payment transaction. Zuora updates Gateway Reconciliation Status to COMPLETED and populates Gateway Reconciliation Reason.
	CANCEL_OR_REFUND + "success" : false	TransactionRejected	Zuora updates the Gateway State field to FailedToSettle on the payment transaction. Gateway Reconciliation Reason is populated with the reason information and Gateway Reconciliation Status is set to DECLINED or DENIED. 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.

Mandate

Adyen Object	Adyen Event	Zuora GR Event	Action on the Gateway state
Mandate	UPDATE + "status": "active"	N/A	Zuora updates the payment method status to “Active”. Zuora updates the mandate status of the payment method to "active". The mandate reason is empty.
	UPDATE + "status": "inactive"	N/A	Zuora updates the payment method status to “Closed”. Zuora updates the mandate status of the payment method to "inactive". The mandate reason is empty.
	UPDATE + "status": "pending"	N/A	N/A