Real-Time Reconciliation events for Adyen v2.0
Zuora supports various event types for Real-Time Reconciliation on Adyen v2.0, including payment, chargeback, refund, and mandate events, with specific actions on the gateway state.
Payment
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:
|
Adyen Object |
Adyen Event |
Zuora GR Event |
Action on the Gateway state |
|---|---|---|---|
|
Payment |
CAPTURE + “success” : true |
TransactionSettled |
Note: Applies only for Delayed Capture enabled merchant accounts when processing a separate capture. |
|
CAPTURE + “success” : false |
TransactionRejected |
Note: Applies only for Delayed Capture enabled merchant accounts when processing a separate capture. | |
|
CANCELLATION + “success” : true |
TransactionRejected |
Note: Applies only for Delayed Capture enabled merchant accounts when processing a separate capture. | |
|
AUTHORISATION + “success” : false |
TransactionRejected |
| |
|
CANCELLATION + “success” : false |
NA |
NA | |
|
AUTHORISATION + “success” : true |
TransactionSettled |
| |
|
AUTHORISATION + “success” : true |
NA |
Note: Applies only when Delayed Capture is enabled. | |
|
CAPTURE_FAILED + “success” : true |
TransactionRejected |
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 |
| |
|
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 |
If a chargeback occurs in a currency different from the settlement currency, the payment amount may slightly differ from the chargeback amount due to foreign exchange (FX) conversion rates. In such cases, Zuora's chargeback validation may fail because of the amount mismatch, and an external refund will not be automatically created. This behavior is expected. You must manually create the external refund in these scenarios.
Refund
|
Adyen Object |
Adyen Event |
Zuora GR Event |
Action on the Gateway state |
|---|---|---|---|
|
Refund |
REFUND + "success" : true |
TransactionSettle |
|
|
REFUND + "success" : false |
TransactionRejected |
| |
|
REFUND_FAILED + "success" : true |
TransactionRejected | ||
|
REFUND_REVERSED + "success" : true |
TransactionRejected | ||
|
REFUND_WITH_DATA + "success" : true |
TransactionSettle |
| |
|
REFUND_WITH_DATA + "success" : false |
TransactionRejected |
| |
|
CANCEL_OR_REFUND + "success" : true |
TransactionSettle |
| |
|
CANCEL_OR_REFUND + "success" : false |
TransactionRejected |
|
Mandate
|
Adyen Object |
Adyen Event |
Zuora GR Event |
Action on the Gateway state |
|
Mandate |
UPDATE + "status": "active" |
N/A |
|
|
UPDATE + "status": "inactive" |
N/A |
| |
|
UPDATE + "status": "pending" |
N/A |
N/A |