Skip to main content

Real-Time Reconciliation events for Adyen v2.0

Zuora

Real-Time Reconciliation events for Adyen v2.0

  1. Last updated
  2. Save as PDF

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

  • Payment
  • Refund
  • RECURRING_CONTRACT for BACS and iDEAL 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.
  • Zuora updates the gateway reconciliation status of the payment to “succeeded”.

If the event fails:

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

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.
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.

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.
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.

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.
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.