Default icon

Enable Adyen Uplift

Learn which features to enable and which decisions to make so that your customers can use Adyen Uplift to optimize conversion, risk, and cost.

View source

Adyen Uplift helps merchants strike a balance between conversion, risk, and cost. Adyen Uplift provides recommendations, experiments, and automation across five modules: Protect, Tokenize, Authenticate, Optimize, and Personalize.

For your customers to benefit from Adyen Uplift, their integration must support specific features. This page explains which features to enable and what decisions you must make for each Adyen Uplift module. If you have not built a partner integration yet, start with the partner integration checklist.

Requirements

Before your customers can use any Adyen Uplift module, their integration must meet the following general requirements.

Requirement Description
Integration type Recommended:Supported with additional requirements:
Webhooks Accept and process webhooks.
Application information Include application information in all payment requests.
Shopper identifiers Include shopperEmail at minimum in payment requests. To get the best results, we highly recommend to also include fields such as shopperReference, shopperIP, and billingAddress.
Other fields For a full list of required and recommended fields to include in payment requests, see Adyen Uplift requirements.

How it works

Adyen Uplift consists of five modules. Each module requires you to enable specific features or make specific decisions. The following table shows an overview.

Module What it does for your customers What you need to do
Protect Fraud management and risk optimization Enable risk, dispute, and data collection features
Tokenize Token-based payments and card details management Enable tokenization and account updater features
Authenticate 3D Secure and authentication optimization Enable 3D Secure 2 support
Optimize Conversion and cost optimization through routing, data, and retries Enable Enhanced Scheme Data, Intelligent Payment Routing, and Auto Rescue; configure payment methods
Personalize Checkout experience optimization Make sure to use a supported Web integration type, preferably the Sessions flow.

Protect

Enable the Protect module so that your customers can use Adyen's risk engine to detect and prevent fraud, reduce chargebacks, and maximize authorization rates. Effective risk management directly increases net revenue: fewer false declines means that more legitimate payments go through, and fewer chargebacks means lower operational costs and potential scheme fines.

For the best synergy with other modules, recommend your customers to enable premium features.

Feature What you need to do Your decision Who does what
Risk profiles Support assigning a risk profile to a merchant account or to individual payments. Decide whether your customers can configure their own risk profile (configurable), or whether you apply a fixed profile for all customers (static). You build the feature. Your customers choose or fine-tune their risk profile.
Disputes Support dispute and chargeback management. Decide whether you capture dispute webhooks centrally, or whether your customers manage disputes entirely from their Customer Area. Adyen sends webhooks. You decide whether to process them. Your customers manage disputes from their Customer Area.
Data collection Collect device and behavior data to help detect fraud. Decide whether to only include the risk data SDK in checkout pages (automatic for certain integration types), or to collect data from additional pages as well. You implement data collection. See fraud data collection.
Data quality Include as many recommended fields as possible in payment requests. High-quality data improves machine learning accuracy and reduces false declines. See risk field reference. None. This is a best practice, not a toggle. The more data you include, the better Protect performs. You include the fields. Adyen uses them for risk evaluation.
Manual transaction review Support manual review of flagged transactions. Decide whether to offer case management. Requires Protect premium. If you do, listen to webhooks or use the API response to flag transactions. You build the feature. Your customers review flagged transactions. Adyen sends case management webhooks.

We recommend making risk configurable so that your customers can fine-tune their risk profile to their specific business needs.

How to enable Protect

  1. Include the risk enabled flag in your configuration object.
  2. Implement fraud data collection to automatically collect and send data such as device information, or send the data manually using riskData.clientData in the payment request.
  3. Include as many recommended fields as possible in payment requests to maximize data quality. At minimum, include shopperEmail, shopperReference, shopperIP, and billingAddress.
  4. Accept and process CHARGEBACK and related dispute event webhooks.
  5. If you offer manual review, listen to case management webhooks and update the transaction status accordingly.

Tokenize

Enable the Tokenize module so that your customers can securely store payment details and use tokens for subsequent payments. Tokenization increases authorization rates because network tokens stay up to date when cards are renewed or replaced. This reduces involuntary churn for subscription businesses and improves the returning shopper experience.

Feature What you need to do Your decision Who does what
Adyen tokenization Implement tokenization with the required fields: shopperReference, storePaymentMethod, recurringProcessingModel, and shopperInteraction. See recurring payment types. None. This is required for the Tokenize module. You build the feature.
Network Tokenization Enable network tokenization for your customers. You can also manage network tokens yourself to provision, update, and delete tokens on behalf of your customers. Decide whether to offer this. It improves authorization rates but requires Adyen-side configuration. Also decide whether you manage tokens centrally or let your customers manage them. You work with your Adyen partner manager to enable it. Adyen configures it. You can manage tokens through the API.
Real Time Account Updater Support the Real Time Account Updater. This is an optional paid feature. RTAU does not send webhooks. When it triggers a card update, read the updated card details from the payment response and update your system accordingly. Decide whether to support this. We recommend that you read additional data in the payment response so your system stays up to date when RTAU triggers a card update. Your customers decide to enable RTAU (paid feature). You read updated card details from the payment response and update your system.
Batch Account Updater Update stored card details in batch. Not recommended due to setup complexity. Use the Real Time Account Updater instead. -

How to enable Tokenize

  1. Implement tokenization by including the required fields in payment requests.
  2. If you offer Network Tokenization, work with your Adyen partner manager to enable it for your customers. Optionally, use the API to manage network tokens yourself.
  3. If your customers enable the Real Time Account Updater, read the updated card details from the payment response and update your system accordingly.

Authenticate

Enable the Authenticate module so that your customers can apply the right authentication mechanism for each transaction to balance security, regulation, and conversion. Smart authentication reduces unnecessary friction for shoppers, which directly improves conversion rates. It also shifts fraud liability to the issuer for authenticated transactions.

Feature What you need to do Your decision Who does what
Native 3D Secure 2 Implement native 3D Secure 2. Choose between native and redirect (or both). Native gives more control over the UX but requires regular upgrades. You build the feature.
Redirect 3D Secure 2 Implement redirect 3D Secure 2. Choose between native and redirect (or both). Redirect is quicker to implement and requires less maintenance. You build the feature.
Override 3D Secure per transaction Let your customers override the 3D Secure decision for specific transactions. Decide whether to expose this to your customers. You build the feature. Your customers use it per transaction.
Rule-based dynamic 3D Secure 2 Let your customers create rules to determine when to apply 3D Secure. Decide whether to expose this to your customers. Your customers set up dynamic 3D Secure rules in their Customer Area.
Dynamic 3D Secure 2 Adyen's Authentication Engine automatically decides when to apply 3D Secure for optimal conversion. None. This is included when you implement 3D Secure 2. Adyen handles this automatically.
Risk-based authentication In combination with the Protect module, and when premium features are enabled, risk-based authentication is enabled by default. None. This is included when you enable the Protect premium module in combination with 3D Secure 2. Adyen handles this automatically.

How to enable Authenticate

  1. Implement either native or redirect 3D Secure 2 (or both).
  2. Make sure you handle the threeDS2 additional action in the payment response.
  3. Include browserInfo in payment requests for the Advanced flow.

Optimize

Enable the Optimize module so that your customers can reduce cost and increase conversion through smart routing, data enrichment, and payment retries. Intelligent Payment Routing uses machine learning to select the lowest-cost or highest-converting route for each transaction. Enhanced Scheme Data lowers interchange fees on qualifying transactions. Auto Rescue recovers revenue from failed recurring payments by automatically retrying at the optimal time.

Feature What you need to do Your decision Who does what
Enhanced Scheme Data (L2/L3) Include Enhanced Scheme Data in payment requests. Listen to webhooks for L2/L3 data outcome. Decide whether to offer this. It lowers interchange fees on US domestic card payments. You build the feature.
Payment methods Support co-badged cards and let your customers add payment methods. Decide which payment methods to support. You build support for co-badged cards. Your customers choose which payment methods to enable.
Intelligent Payment Routing Use machine learning to route each transaction to the highest-converting or lowest-cost acquirer or network. Requires at least two available routes (for example, a local scheme and an international scheme). No integration work is needed. Decide whether to enable this for your customers. It is off by default and requires a one-click enablement in the Customer Area. For US and Australia, choose between: balance conversion and cost (recommended), prioritize cost, or prioritize conversion. You make sure multiple routes or MCCs are configured. Your customers enable routing optimization in their Customer Area under Uplift > Optimize. Adyen handles routing.
Smart Payment Messaging Adyen optimizes issuer messaging (for example, CVC and AVS fields) to increase authorization rates on low-risk transactions. This is enabled by default. Your customers can adjust the optimization level in their Customer Area under Uplift > Optimize. Decide whether to expose this setting. Adyen handles this automatically. Your customers can change the optimization level.
Auto Rescue Enable Auto Rescue to automatically retry failed recurring payments. This recovers revenue that would otherwise be lost to soft declines. Decide whether to enable Auto Rescue per transaction or on the merchant account level. You choose the level (transaction or merchant account). Adyen retries the payment. You process the webhooks to update your system.

The Excessive Retry Prevention Service (ERPS) blocks transactions that would incur Visa or Mastercard excessive retry penalty fees. It is opt-in, not priced, and in maintenance mode. ERPS can reduce scheme penalty fees but may have a negative impact on authorization rates. Contact your Adyen partner manager if your customers need this.

How to enable Optimize

  1. Include Enhanced Scheme Data fields (additionalData.enhancedSchemeData) in payment requests for US domestic card payments.
  2. Listen to webhooks for L2/L3 data outcome to verify that the scheme accepted the enhanced data.
  3. Support co-badged cards (Web Drop-in or Components v6.16.0 minimum, recommended v6.18.1).
  4. If you offer Auto Rescue, enable it per transaction or on the merchant account. Process the Auto Rescue webhooks to update your system with the retry outcome.
  5. For Intelligent Payment Routing, make sure at least two routes (schemes or MCCs) are configured. Your customers enable routing optimization in their Customer Area. No integration changes are required.
  6. Smart Payment Messaging works automatically. No integration changes are required.

Personalize

Enable the Personalize module so that your customers can optimize the checkout experience for shoppers. This module includes dynamic payment method ordering and checkout experiments. Showing the right payment method at the right time increases conversion and reduces drop-off at checkout.

Feature What you need to do Your decision Who does what
Dynamic Payment Method Ordering Dynamically order payment methods to optimize conversion or cost. If you use the Sessions flow, this works automatically. For the Advanced flow, make sure payment methods display in the same order as returned in the response. Adyen determines the optimal order. You display it.
Experiments Let your customers run A/B tests on payment methods or ordering strategies. None. This is managed entirely from the Customer Area. Your customers manage this. You do not need to make any changes.
Shopper conversion identifier Link a shopper to a single checkout session for better personalization. Required for the Advanced flow. Include shopperConversionId in /payments and /paymentMethods requests. You build this into the integration.

If you use the Sessions flow, Personalize works automatically. For the Advanced flow, include shopperConversionId to link a shopper to a single checkout session and make sure payment methods display in the same order as returned in the API response.

How to enable Personalize

  1. Include shopper identifiers in payment requests. At minimum, include shopperEmail.
  2. For the Advanced flow, generate and include a shopperConversionId in the /payments and /paymentMethods requests.
  3. Make sure the order of payment methods in the checkout matches the order returned in the payment methods response.

See also