home

Zuora Payments

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Payments

Enable Adyen Real-Time Reconciliation in Zuora

Configure a webhook in your Adyen merchant console

  1. Log in to your Adyen merchant console and navigate to Developers > Webhooks.
  2. On the Webhooks page, click Settings, ensure Recurring contract is selected, and then click Save.
  3. On the Webhooks page, click Webhook to add a webhook.
  4. In the Standard webhook row, click Add.
  5. Configure the webhook settings:
    1. Edit the Server configuration setting:

      • Click the Edit icon in the General > Server configuration section.

      • In the URL field, enter the service URL using the <Zuora_Data_Center_URL>/payment-reconciliation-webhook/adyen/v1 format, such as https://rest.sandbox.na.zuora.com/payment-reconciliation-webhook/adyen/v1. You can know which data center you are in by checking the URL of your environment. For details about Zuora environments, see Zuora Data Centers.

      • Keep default values for the other fields.

      • Click Apply.

    2. Edit the Merchant accounts setting:

      • Click the Edit icon in the General > Merchant accounts section.

      • Select only the merchant account that this webhook is intended for. If you select multiple accounts, in the later Step 2, you will need to provide the required information about each of the merchant accounts to Zuora to enable Real-Time Reconciliation.

      • Click Apply.

    3. Edit the Events setting:

      • Click the Edit icon in the General > Events section.

      • Select the following options:

      • AUTHORISATION
      • CANCEL_OR_REFUND
      • CHARGEBACK
      • PAYOUT_THIRDPARTY
      • RECURRING_CONTRACT
      • REFUND
      • REFUND_FAILED
      • OFFER_CLOSED

      • Click Apply.

    4. Edit the risk setting:

      • Click the Edit icon in the Additional settings > Risk section.

      • Select Include Gross Currency Chargeback Details.

      • Click Apply.

    5. Generate an HMAC key:
    6. Click the Edit icon in the Security > HMAC Key section.
    7. Ensure Generate new key is selected and click Generate.
    8. Copy and store the key in your device. In the later Step 2, you will need to provide this key to Zuora to enable Real-Time Reconciliation.
    9. Click Apply.
  6. Click Save changes. The webhook is saved in active status. Before Real-Time Reconciliation is enabled in Zuora, it is suggested to disable the webhook.
  7. To disable the webhook, on the Webhooks page, hover over the webhook you just created, click the More Options icon , and then click Disable webhook.

Last updated: November 17, 2025