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 |
|
| 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 |
|
|
Apple Pay |
|
| SEPA |
|
| Credit Card |
|
| Credit Card Reference Transaction |
|
|
Google Pay |
|
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