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

Adyen Integration v2.0 supports the following payment method types. For more information about setting up payment methods in Zuora, see Define and set up payment methods.

ACH

ACH payment method verification is supported through the ValidiFi account validation service. See Enable the support for ValidiFi account validation for ACH for details.

Apple Pay

To configure and use an Adyen Apple Pay payment method, follow the instructions in Set up Adyen Apple Pay.

Credit Card

To tokenize Credit Card payment methods,  enable Submit Card Payments with RecurringDetailReference in the configuration settings of the payment gateway instance. See Set up and configure an Adyen Integration v2.0 gateway instance for details. For now, Zuora supports Credit Card tokenization on Adyen only through this approach.

  • Visa
  • MasterCard
  • Discover
  • American Express
  • JCB
  • Diners Club
  • China Union Pay

Credit Card Reference Transaction

See Credit Card Reference Transactions on Adyen Integration v2.0 for more information.

Google Pay

To set up and use an Adyen Google Pay payment method, follow the instructions in Set up Google Pay for Adyen Integration v2.0.

SEPA

You can create non-tokenized SEPA payment methods with IBAN through the UI, API operation, or hosted payment page.

To create tokenized SEPA payment methods, see Tokenize SEPA payment methods on Adyen Integration v2.0.

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
  • Validate
  • 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. You can use the Create authorization API operation to authorize a payment amount before capturing the payment. Subsequently, you can use Create a payment or Create an order to capture the authorized amount, or use Cancel authorization to cancel the authorization. 

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.

To ensure the network transaction ID (NTI) is returned from Adyen and saved in Zuora for processing recurring payments, you must enable the Network transaction reference setting at the Adyen side .

Support for Gateway Reconciliation

The following Gateway Reconciliation event types are supported:

  • Settlement
  • Rejection
  • Chargeback

For more information, see Gateway Reconciliation on Adyen.

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, except for SEPA transactions:

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