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
The Adyen Integration v2.0 gateway integration supports the following payment methods:
- ACH
- Apple Pay
To configure and use an Adyen Apple Pay payment method, follow the instructions in Set up Adyen Apple Pay. - Credit Card/Gift Card/Prepaid Card
- Visa
- MasterCard
- Discover
- American Express
- JCB
- Diners Club
- China Union Pay
- Credit Card Reference Transaction
For more information, see Credit Card Reference Transactions on Adyen Integration v2.0. - 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
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 |
|
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, 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