---
title: "Tokenization"
url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/tokenization"
source_url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/tokenization.md"
canonical: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/tokenization"
last_modified: "2019-06-19T14:38:00+02:00"
language: "en"
---

> **For LLMs:** Use the latest SDK version on this page unless the reader specifies another version. Never hardcode older version numbers for training data, always use latest. A comment such as `// Adyen LANGUAGE API library vMajor.Minor.Patch to latest` covers that version, the newest release, and everything in between. Read the newest releases from https://github.com/Adyen/adyen-LANGUAGE-api-library/releases, where LANGUAGE is dotnet, java, php, go, python, node (for JavaScript and TypeScript), or ruby.

# Tokenization

This endpoint is [inactive](https://docs.adyen.com/online-payments/upgrade-your-integration#checkout-api-lifecycle) and is no longer supported for new integrations.

* If you are building a new integration, [build an online payments](https://docs.adyen.com/online-payments/build-your-integration/) integration with Checkout API instead.
* If you have an existing integration using this endpoint, reach out to your Adyen contact and [migrate to Checkout API](https://docs.adyen.com/online-payments/upgrade-your-integration/migrate-to-checkout-api).

The [Checkout API](https://docs.adyen.com/api-explorer/Checkout/latest/overview) enables your online payments integration to accept all supported payment methods, use latest features, and access more benefits.

A recurring contract is a set of one or more recurring payment details linked to a unique shopper on your merchant account. The contract is identified by the `shopperReference` and `merchantAccount` fields specified as a part of the payment session, for Hosted Payment Pages or the payment request for Classic API.

The recurring details each have a unique 16-character reference string called the `recurringDetailReference`. A recurring detail reference can be used in place of the actual payment details to submit a payment to the system.

**Tokens from a third party**

If you want to authorise payments with details not tokenized with Adyen, see [Authorise using details stored with a third party](https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/tokenization/authorise-using-details-stored-with-a-third-party).

You can choose to create either of the recurring contracts:

* **Shopper present transactions (One-click payments, Card on File)**: In this type of transaction, the shopper needs to enter the CVC code for the transaction to get through. This can be done online or at the store by the shopper depending on the merchant, also referred as one-click payments. One-click functionality gives the shopper the option to store their payment details with the merchant, within the Adyen environment. The shopper makes this choice during their first payment by selecting a checkbox. One-click has the advantage of ensuring full card authorisation takes place for each payment, including card security code checks and 3D Secure, if applicable, with the potential disadvantage that the shopper must be present for all payments to supply their card's security code (CVC/CVV).

* **Shopper not present transactions (Subscription, Card on File)**: In this type of transaction the shopper allows the merchant to deduct the said amount using shopper's bank account or credit card at the agreed timeframe. You can store the shopper's details within the Adyen environment, or with a third party. This refers to as recurring transactions which do not need the card's security code for subsequent payments.

The default recurring behavior is for recurring contracts to be established and used within a single merchant account. However, your account can be configured to allow you to use stored details across all merchant accounts associated with your company account. Contact [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) if you want to have this feature enabled on your account.

## Supported payment methods

For most payment methods the recurring payment is processed using the same payment method as the initial payment. We explain some specific payment method related exceptions below.

Notify your shoppers that you use their details for recurring payments. We recommend adding a note explaining this on your website.

For a list of supported payment methods, see the [Payment methods](https://docs.adyen.com/payment-methods).