Skip to main content

Real-Time Reconciliation events for Adyen v2.0

Zuora

Real-Time Reconciliation events for Adyen v2.0

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

  • Payment
  • Refund
  • RECURRING_CONTRACT for BACS and iDEAL transactions 
  • OFFER_CLOSED for UPI transactions

The following table lists Zuora's actions after receiving Adyen events.

Adyen webhook event Zuora’s action
RECURRING_CONTRACT Zuora retrieves recurringDetailReference from the pspReference field, stores this token, and uses it to process recurring BACS and iDEAL transactions.
AUTHORISATION

Zuora handles this event for processed payments. Error payments will not be reconciled.

If the event is successful, Zuora updates the Gateway State to "Settled" on the Payment transaction. No value is populated in Gateway Reconciliation Status or Gateway Reconciliation Reason.

If the event fails:

  • Zuora updates the Gateway State to "FailedToSettle" on the payment transaction. Gateway Reconciliation Reason is populated with the reason information but Gateway Reconciliation Status 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.
CANCEL_OR_REFUND

Zuora handles this event for processed refunds. Error refunds will not be reconciled. 

If the event is successful, Zuora updates the Gateway State to "Settle" on the refund transaction. No value is populated in Gateway Reconciliation Status or Gateway Reconciliation Reason.

If the event fails, 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. Gateway Reconciliation Reason is populated with the reason information but Gateway Reconciliation Status is not populated.

CHARGEBACK

Zuora handles this event for processed payments. Error payments will not be reconciled.

If the event is successful:

  • Zuora creates an external refund only if the chargeback currency is the same as the payment currency. 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 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.
  • No value is populated in Gateway Reconciliation Status or Gateway Reconciliation Reason.

If you do not want Zuora to create refunds for chargeback events, submit a request to Zuora Global Support.

PAYOUT_THIRDPARTY If the event is successful, Zuora updates the payment with payout_id. No value is populated in Gateway Reconciliation Status or Gateway Reconciliation Reason.
REFUND

Zuora handles this event for processed refunds. Error refunds will not be reconciled.

If the event is successful, Zuora updates the Gateway State to "Settle" on the refund transaction. No value is populated in Gateway Reconciliation Status or Gateway Reconciliation Reason.

If the event fails, 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. Gateway Reconciliation Reason is populated with the reason information but Gateway Reconciliation Status is not populated.

REFUND_FAILED If the event is successful, 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. No value is populated in Gateway Reconciliation Status or Gateway Reconciliation Reason.
OFFER_CLOSED

Zuora handles this event for processed payments. Error payments will not be reconciled.

If the event is successful:

  • Zuora updates the Gateway State to "FailedToSettle" on the payment transaction.
  • Zuora updates the Gateway Reconciliation Reason with "Transaction timeout".
  • 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.