Plugins-2 icon

Set up tokenization

Store your shopper's payment details for later payments.

This page describes the tokenization setup for v9.0.1 or later. If you are using an earlier version, see the older documentation.

Adyen's plugin allows you to securely store the payment details of shoppers, giving your returning shoppers a faster checkout experience. We refer to these saved payment details as tokens and storing a shopper's payment details as tokenization.

Tokenization can be done for card, Amazon Pay, Google Pay, Apple Pay, SEPA, Klarna, PayPal, iDEAL, Payconiq by Bancontact and in-person payments. For additional payment methods to be tokenized, request a new feature on our GitHub page.

How it works

When a shopper is making a payment, a Save for my next payment checkbox will appear. If the checkbox is selected, shopper payment details will be securely stored. The plugin uses the Adobe Commerce Vault to store the token information.

The shopper can choose express checkout, by selecting an Instant purchase button right next to the product. The shopper will be asked to provide their CVC to complete the payment.

Requirements

Step 1: Set up the Vault in Adobe Commerce

  1. Log in to your Adobe Commerce admin panel.
  2. In the left navigation bar, go to Stores > Configuration.
  3. In the menu, go to Sales > Payment Methods.
  4. Select Configure next to Adyen Payments.
  5. Go to Payment Optimization > Tokenization and fill in the following fields for each payment method you want to tokenize:
Field Description
Payment method The payment method that you want to tokenize.
Enabled Select Yes to enable tokenization for the payment method.
Recurring Processing Model Set to CardOnFile, UnscheduledCardOnFile, or Subscription depending on how you want to use tokenization.
Require CVC for card payments Select Yes to require CVC for card vault payments.
Allow multistore tokens Select Yes to allow shoppers to use their tokenized payment details from a different Magento storefront when making a payment.

If you want to use more than one type of Recurring Processing Model, complete your set up with the type that is most relevant for your business. In the subsequent transactions, you can specify another applicable type.

  1. Select Save Config in the upper right corner.

Step 2: Set up recurring contracts in Adyen

  1. Log in to your Customer Area, and switch to your merchant account.
  2. Go to Developers > Additional data.
  3. Under Card, select the following fields:
    • Cardholder name
    • Card bin
    • Card summary
    • Expiry date
    • Variant
  4. Under Payment, select the following field:
    • Recurring details
  5. Select Save configuration.

Step 3 (optional): Configure risk settings in Adyen Customer Area

Optionally, you can apply risk rules to tokenized payments. To configure risk settings that apply to tokenized payments:

  1. Log in to your Customer Area, and switch to your merchant account.
  2. Go to Revenue & risk > Settings.
  3. Turn on Exclude recurring transactions from risk evaluation.
  4. Turn off IP-based risk checks for recurring transactions and Velocity risk checks for recurring transactions.

Subscription payments

Adyen's tokens are valued for automatic subscription payments. However, there is no functionality native to Adobe Commerce that supports automatic transactions where the shopper is not present. Implementing subscription payments therefore requires additional integration effort.

Shopper tokens are stored in the vault_payment_token database table. For each token, this table includes:

  • shopperReference: Stored in Adobe Commerce as the customer_id.
  • storedPaymentMethodId: Stored in Adobe Commerce as the gateway_token.

For more information on how to implement automatic subscription payments with Adyen's API, refer to our Tokenization guide.

In-person payments

If you want to save the payments details for payments made in-person, set up recurring payments for In-person payments.

See also