---
title: "Set up tokenization"
description: "Learn how to configure tokenization in NetSuite."
url: "https://docs.adyen.com/plugins/netsuite/set-up-tokenization"
source_url: "https://docs.adyen.com/plugins/netsuite/set-up-tokenization.md"
canonical: "https://docs.adyen.com/plugins/netsuite/set-up-tokenization"
last_modified: "2023-11-20T13:50:00+01:00"
language: "en"
---

# Set up tokenization

Learn how to configure tokenization in NetSuite.

[View source](/plugins/netsuite/set-up-tokenization.md)

Our NetSuite integration allows you to securely store shopper payment details for recurring payments.

## Requirements

You must turn on the **Payment Instruments** feature in Netsuite for tokenization to work. Turning on this feature changes the UI and the fields in NetSuite.

This feature presents a set of fields that can be used to charge a shopper without any action on the shopper's side, and enables tokenization.

You must [configure custom preferences for Pay by Link](/plugins/netsuite/set-up-pay-by-link#configure-pay-by-link-custom-preferences) if you want to enable tokenization for Pay by Link payments.

## Configure tokenization

To configure tokenization for Adyen transactions:

* In Netsuite, [edit the payment processing profile](#edit-profile) you use with Adyen.
* In the Customer Area, [select data to receive](#select-data-to-receive) from Adyen.

### Edit the payment processing profile

1. Log in to your NetSuite Customer Center.

2. Go to **Setup** > **Accounting** > **Payment Processing Profiles** and select the profile you use with Adyen.

3. Select **Edit** and configure the following fields under **\[ES] Adyen SuitePayment Main Config**:

   | Field                                 | Description                                                                                                                                                                                                                                                                                                                 |
   | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | PAYMENT CARD TOKENIZATION             | Select **Yes** if you want to tokenize payment cards. Otherwise, select **No**.                                                                                                                                                                                                                                             |
   | RECURRING PROCESSING MODEL            | Select a default recurring processing model from **CardOnFile**, **UnscheduledCardOnFile**, or **Subscription** depending on [how you want to use tokenization](https://help.adyen.com/knowledge/ecommerce-integrations/tokenization/how-to-choose-recurring-processing-model). This will be sent with the payment request. |
   | PAY BY LINK: TOKENIZATION             | Select the checkbox if you want to tokenize shopper payment details used in a [Pay by Link](/plugins/netsuite/set-up-pay-by-link) transaction.                                                                                                                                                                              |
   | PAY BY LINK: DEFAULT VIA TOKENIZATION | Select the checkbox if you want to save the tokenized payment details for a [Pay by Link](/plugins/netsuite/set-up-pay-by-link) transaction as the default payment method for a shopper. This feature only works if the PAY BY LINK: TOKENIZATION box is also checked.                                                      |

4. Under the **Tokenization** section in your Payment Processing Profile, configure the following fields:

   | Field                             | Description                                                                                                                                                                                                                                             |
   | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | REPLACE PAYMENT CARD BY TOKEN     | Select this checkbox if you want a token to replace payment card details. This only applies if **PAYMENT CARD TOKENIZATION** under **\[ES] Adyen SuitePayment Main Config** is set to **Yes**.                                                          |
   | PAYMENT CARD TOKEN PAYMENT METHOD | Select **Payment Card Token** if you want to use this token for this profile. You can configure this token in the [initial NetSuite Customer Center setup](/plugins/netsuite/set-up-netsuite-customer-center#cards-token-payment-method-instance).      |
   | GENERAL TOKEN PAYMENT METHOD      | Select **Payment General Token** if you want to use this token for this profile. You can configure this token in the [initial NetSuite Customer Center setup](/plugins/netsuite/set-up-netsuite-customer-center#general-token-payment-method-instance). |

5. Add the token to the relevant [payment method instance](/plugins/netsuite/set-up-netsuite-customer-center#cards-token-payment-method-instance).

### Select data to receive

1. Log in to your [Customer Area](https://ca-test.adyen.com/), 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**.

## Import an existing token

### Store a token in a Customer Record

1. Go to **Lists** > **Relationships** > **Customers**. Select **View** for the customer record you want to view.

2. Select **Edit**. Go to the **Financial** tab and select the **Payment Instruments** tab. Select **New**.

3. Configure the following fields:

   | Field          | Description                                                                               |
   | -------------- | ----------------------------------------------------------------------------------------- |
   | TYPE           | Select either **General Token** or **Payment Card Token**.                                |
   | PAYMENT METHOD | Select either **Adyen General Token** or **Adyen Card Token**, depending on the **TYPE**. |
   | TOKEN          | Enter the token.                                                                          |
   | TOKEN FAMILY   | Select **Adyen**.                                                                         |

4) Fill out the other relevant fields on the page and select **Save**.

If you want to import a token created outside of NetSuite, you need to add an Adyen Shopper Reference. If you do not add a shopper reference, NetSuite uses the shopper's internal ID as the Adyen Shopper Reference. Adyen invalidates any existing token that does not match the Adyen Shopper Reference.

### Add an Adyen shopper reference

1. Select **Edit** in the Customer Record.
2. Go to **Classification** and enter the Adyen Shopper Reference in the **ADYEN SHOPPER REFERENCE** field.
3. Select **Save**.

## Manually create tokens

To tokenize payment details of your shoppers after they have completed a payment

## Overwrite tokenization options in a transaction

You can override tokenization options for a transaction using a credit card when processing the transaction.

1. Go to the Transaction for which you want to override tokenization options.

2. Select **Edit** and go to the **Billing** tab.

3. In the **Payment** tab, configure the following fields:

   | Field                                     | Description                                                                                                                                                        |
   | ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | ADYEN PAYMENT CARD TOKENIZATION OVERRIDE  | Select **Yes** to tokenize the transaction. Select **No** to not tokenize the transaction. Leave blank to inherit the setting from the Payment Processing Profile. |
   | ADYEN RECURRING PROCESSING MODEL OVERRIDE | Select the Recurring Processing Model you want to use. Leave blank to inherit the setting from the Payment Processing Profile.                                     |

## Notifications

Before you can receive token notifications, you need to:

1. [Set up webhooks](/plugins/netsuite/set-up-adyen-customer-area#set-up-webhooks).
2. Enable the [**RECURRING\_CONTRACT** ](/development-resources/webhooks/webhook-types#non-default-event-codes)event code.

### General token notifications

After you have enabled the **RECURRING\_CONTRACT** webhook, NetSuite creates general tokens for each payment detail used in non-card payments upon receiving the webhook.

You get a general token notification when a non-card token is created. General token notifications do not include notifications for card payment tokens.

To set up company-wide general token notifications:

1. Go to **Setup** > **Company** > **General Preferences** and go to the **Custom Preferences** tab.
2. Go to the **GENERAL TOKEN: PAYMENT METHOD** field and select the payment method to use when generating a general token.

To view general token notifications:

1. Go to **Transactions** > **Management** > **View Gateway Asynchronous Notifications**.
2. Select the notification you want to view.

### Card payment token notifications

To view notifications for transactions that use card payment tokens:

1. Go to the transaction page for the order you want to view.
2. Go to the **Billing** tab. Under the **Payment** tab, you can see notifications.

To validate if a token was created, you can go to a Customer Record and see their token in the payment instrument.

## See also

* [Set up NetSuite Customer Center](/plugins/netsuite/set-up-netsuite-customer-center)
