Skip to main content

Overview of Adyen Integration v2.0

Zuora

Overview of Adyen Integration v2.0

Zuora partners with Adyen and provides Adyen Integration v2.0 as the latest version of Adyen gateway integration service. If you are still using the legacy Adyen gateway integration, it is highly recommended that you migrate to Adyen Integration v2.0 to take advantage of increased success rates and reduced needs for interacting with your platform.

Supported features

The following table provides a quick reference for the supported features. For details about each feature, see the later sections in this article.

Supported payment methods ACH, Apple Pay, Credit Card/Gift Card/Prepaid Card, Credit Card Reference Transaction, Google Pay, SEPA
Supported payment operations Validate, Payment, Referenced refund, Non-referenced refund
Support 3D Secure 2.0 Yes
Support Delayed Capture Yes
Support Level 2 and Level 3 card data Yes
Support stored credential transactions Yes
Support Gateway Options fields Yes
Gateway provider’s API version Adyen Checkout API v66, Payment API v68 and Payout API v68 (for ACH non-reference refunds)
Adyen production endpoint used for Zuora gateway integration service

https://<prefix>-checkout-live.adyenpayments.com/checkout/v49/payments

https://<prefix>-checkout-live.adyenpayments.com/checkout/v1/originKeys

https://<prefix>-checkout-live.adyenpayments.com/checkout/v1/payment/details

https://<prefix>-pal-live.adyenpayments.com/pal/servlet/Payment/v40

https://<prefix>-pal-live.adyenpayments.com/pal/servlet/Recurring/v40/listRecurringDetails

Support Gateway Reconciliation Yes
Adyen production endpoint used for Gateway Reconciliation service https://ca-live.adyen.com/reports/download/
Support Payment Method Updater Yes (Visa, MasterCard)
Adyen production endpoint used for PMU service sftp://sftp-live.adyen.com:5631
Support idempotency for retrying a transaction request Yes. See Electronic payment processing for details.

Supported payment methods

The Adyen Integration v2.0 gateway integration supports the following payment methods:

For more information about setting up payment methods in Zuora, see Define and set up payment methods.

Supported payment operations

The following table describes the supported payment operations for each supported payment method:

Supported Payment Method Payment Operations
ACH
  • Payment
  • Referenced refund
  • Non-referenced refund

Apple Pay 

  • Validate
  • Payment
SEPA
  • Payment
  • Referenced refund
  • Non-referenced refund
Credit Card
  • Validate
  • Payment
  • Referenced refund
  • Non-referenced refund
Credit Card Reference Transaction
  • Validate
  • Payment
  • Referenced refund
  • Non-referenced refund

Google Pay

  • Validate
  • Payment
  • Referenced refund
  • Non-referenced refund

Support for 3D Secure 2.0

With 3D Secure 2.0 enabled, the value of the authorization amount will be used as the authentication amount, and the authorization amount is always 0.

See Enable 3DS2 for Adyen gateway integration and Zuora’s implementation of 3D Secure 2.0 for more information.

Support for Delayed Capture

The Delayed Capture feature allows you to authorize the availability of funds for a transaction but delay the capture of funds until a later time. Adyen Integration v2.0 supports Delayed Capture for Credit Card and Google Pay payment methods, which involves the use of the following API operations:

Zuora also supports capturing authorizations that were generated externally to call the Zuora's Create authorization API operation. 

The following table lists the mapping of reference fields that are used in the delayed capture process for credit card and Google Pay transactions.

Zuora Field Adyen Field
Transaction ID pspReference
Payment Number reference
Payment Number merchantReference

Support for Level 2 and Level 3 card data processing

The Adyen Integration v2.0 gateway integration supports processing Level 2 and Level 3 credit card data. For more information, see the following articles:

Support for stored credential profiles

Adyen Integration v2.0 includes support for the Stored Credential Transactions framework. For details about the supported payment methods, see Support for stored credential transactions overview.

Support for Gateway Reconciliation

Adyen Integration v2.0 supports the following Gateway Reconciliation event types:

  • Settlement
  • Rejection
  • Chargeback

For more information about enabling and configuring the Gateway Reconciliation service, see the following articles:

Support for Payment Method Updater

You can configure Adyen Payment Method Updater to keep Zuora and you informed about the changes to the credit card information. For more information, see Configure Adyen Payment Method Updater.

Supported Gateway Options fields

You can submit additional information to the Adyen gateway by using Gateway Options fields. For details about the fields supported by Adyen Integration v2.0, see Gateway Options fields supported by Adyen Integration v2.0.

Limitations

The following operations are not supported by Adyen:

  • Validate an existing mandate Id
  • Use a mandate Id for payments