---
title: "Set up NetSuite Customer Center"
url: "https://docs.adyen.com/plugins/netsuite/set-up-netsuite-customer-center"
source_url: "https://docs.adyen.com/plugins/netsuite/set-up-netsuite-customer-center.md"
canonical: "https://docs.adyen.com/plugins/netsuite/set-up-netsuite-customer-center"
last_modified: "2024-12-30T15:55:00+01:00"
language: "en"
---

# Set up NetSuite Customer Center

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

To set up the Adyen plugin for NetSuite:

1. [Install the Adyen payments bundles](#install-the-adyen-payments-bundles).
2. [Create a payment method instance](#create-a-payment-method-instance).
3. [Create a payment processing profile](#create-a-payment-processing-profile).
4. (Optional) [Set up email alerts](#set-up-email-alerts): receive emails informing you of transactions that require additional attention.

## Install the Adyen payments bundles

### Step 1: Install the NetSuite Chargeback Workflow Bundle

The **NetSuite Chargeback Workflow Bundle** directly supports the chargeback processing and the notification system, where financial transactions and related updates are being received by NetSuite on a schedule determined by outside systems. The notifications listener is active at all times and chargeback notifications are received and shown on the Notifications main listing for user review.

To install this bundle:

1. Log in to your NetSuite Customer Center.

2. Go to **Setup** > **Accounting** > **Accounting Preferences** > **Items/Transactions**.

3. Scroll down to the **Payment Processing** section.

4. Select the following checkboxes:

   * USE CARD SECURITY CODE FOR CREDIT CARD TRANSACTIONS

   * ALLOW ADJUSTED EXPIRATION DATE TO IMPROVE RECURRING PAYMENTS

   * PRESERVE TRANSACTIONS WHEN PAYMENT IS ON HOLD

   If you process POS payments, also select the following checkbox:

   * PRESERVE TRANSACTIONS WHEN PAYMENT IS ON HOLD

5. Select **Save**.

6. Go to **Customization** > **SuiteBundler** > **Search & Install Bundles**.

7. Search for the **Chargeback Workflow Bundle (ID: 127355)**.

8. Select **Install**.

To view your chargebacks in the NetSuite Customer Center, go to **Transactions** > **Management** > **View chargeback notifications**.

### Step 2: Install the ADYEN - SuitePayments Bundle

Before you begin, make sure that you have installed the **NetSuite Chargeback Workflow Bundle** in [Step 1](#step-1).

The **ADYEN - SuitePayments Bundle** directly supports payment processing between NetSuite clients and Adyen, allowing you to accept:

* Credit cards
* Local payment methods

To install this bundle:

1. Log in to your NetSuite Customer Center.
2. Go to **Customization** > **SuiteBundler** > **Search & Install Bundles**.
3. Search for the **Adyen Payments Bundle for NetSuite (ID:125171)**.
4. Select **Install**.
5. After the installation is complete, go to **Customization** > **Plug-ins** > **Manage Plug-ins**.
6. Select **ADYEN SUITEPAYMENTS IMPLEMENTATION** to activate the bundle.

## Create a payment method instance

The payment method instances define which payment methods and token types are available for a payment processing profile.

For each of the following payment methods, you need to create a separate payment method instance if you accept payments of that type:

* [Cards](#cards-payment-method-instance)
* [ACH Direct Debit](#ACH-direct-debit-instance)
* [BACS Direct Debit](#bacs-direct-debit-instance)
* [Local payment methods (Hosted Checkout)](#local-payment-method-hosted-checkout-payment-method-instance)
* [Klarna](#klarna-payment-method-instance)
* [WeChat Pay](#wechatpay-payment-method-instance)
* [Pay by Link](#pay-by-link-payment-method-instance)
* [Pay by Reference](#refund-unreferenced-invoices-instance)

If you want to use [tokenization in NetSuite](/plugins/netsuite/tokenization-in-netsuite), you also need to specify which token type to use:

* [Card token](#cards-token-payment-method-instance)
* [General token](#general-token-payment-method-instance)

Before creating payment method instances, make sure that **PAYMENT INSTRUMENTS** are **enabled**. As an exception, for debit cards, make sure that **PAYMENT INSTRUMENTS** are **disabled**.

#### Enable PAYMENT INSTRUMENTS

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Company** > **Enable Features** >  **Transactions** > **Payment Processing**.
3. Enable the **PAYMENT INSTRUMENTS** checkbox.

### Cards

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Set **TYPE** to **Payment Card**.
5. Select the correct **CARD BRANDS** from the list (if available).
6. Select the **DISPLAY IN WEB SITE** checkbox when using SuiteCommerce Advanced.

### ACH Direct Debit

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Set **TYPE** to **ACH**.
5. Select the **DISPLAY IN WEB SITE** checkbox when using SuiteCommerce Advanced.

### BACS Direct Debit

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Set **TYPE** to **External Checkout**.
5. Select the **DISPLAY IN WEB SITE** checkbox.

### Local payment methods (Hosted Checkout)

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Set **TYPE** to **External Checkout**.
5. Select the **DISPLAY IN WEB SITE** checkbox.

### Klarna

You need to create a separate payment method instance for each payment method you are accepting. **Klarna Pay later** and **Klarna Pay over time** are different payment methods. When using Klarna, make sure your Payment Processing Profiles include the **Support Line Level Data** checkbox.

1. Log in to your NetSuite Customer Center.

2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.

3. Select **Payment method**.

4. Set **TYPE** to **External Checkout**.

5. Select the **DISPLAY IN WEB SITE** checkbox.

6. For Klarna payment methods, select the **REQUIRES LINE-LEVEL DATA** checkbox.

7. Go to **Payment Visuals** and fill out the **FLAGS** and **URL** fields.

   * **FLAGS**: the flags used to refer to the image for this payment method on your site. If you are using a SiteBuilder website, enter **web/standard**. If you are using a SuiteCommerce Advanced site, use any flag that your code uses to refer to the image.
   * **URL**: the URL for the image for this payment method on your site.

8. Set **ASSOCIATED PROCESSING PROFILES** to the payment profile you use with Adyen.

### WeChat Pay

1. Log in to your NetSuite Customer Center.

2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.

3. Select **Payment method**.

4. Set **TYPE** to **External Checkout**.

5. Select the **DISPLAY IN WEB SITE** checkbox.

6. Go to **Payment Visuals** and fill out the **FLAGS** and **URL** fields.

   * **FLAGS**: the flags used to refer to the image for this payment method on your site. If you are using a SiteBuilder website, enter **web/standard**. If you are using a SuiteCommerce Advanced site, use any flag that your code uses to refer to the image.
   * **URL**: the URL for the image for this payment method on your site.

7. Set **ASSOCIATED PROCESSING PROFILES** to the payment profile you use with Adyen.

### Pay by Link

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Set **TYPE** to **External Checkout**.
5. Leave **REQUIRES LINE-LEVEL DATA** disabled
6. Set **ASSOCIATED PROCESSING PROFILES** to the payment profile you use with Adyen.

### Pay by Reference

Pay by Reference transactions are Pay by Link [invoice](/plugins/netsuite/#netsuite-glossary) payments. To set up a Pay by Reference payment method instance, **PAYMENT INSTRUMENTS** must be enabled.

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Set **TYPE** to **Pay by Reference**.

### Card token

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Set **TYPE** to **Payment Card Token**.

### General token

1. Log in to your NetSuite Customer Center.
2. Go to **Setup** > **Accounting** > **Accounting Lists** >  **New**.
3. Select **Payment method**.
4. Name it as **Adyen General Token**
5. Set **TYPE** to **Payment General Token**.

## Create a payment processing profile

A payment processing profile can process payments in multiple currencies, but can only settle in one currency and to one bank account. Therefore, you need to create a separate payment processing profile for each currency in which you want to be settled in.

Additionally, we recommend that you create a separate payment processing profile for:

* Credit cards and local payment methods
* Each NetSuite subsidiary that uses Adyen for payment processing

To create a payment processing profile:

1. Log in to your NetSuite Customer Center.

2. Go to  **Setup** > **Accounting** > **Payment Processing Profiles** > **New**.

3. Find **Adyen** in the **Name column**, and select **Add Profile**. This opens a page for editing the new profile. Fill out the following fields:

   | Field                   | Description                                                                                                                                                                                              |
   | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | WEB SITE                | Select the websites that you want to configure for this profile.                                                                                                                                         |
   | NAME                    | A unique name for this profile.                                                                                                                                                                          |
   | SUBSIDIARY              | The NetSuite subsidiary for this profile.                                                                                                                                                                |
   | SETTLEMENT CURRENCY     | The currency in which Adyen should pay out to your bank account.                                                                                                                                         |
   | CHARGE CURRENCIES       | The currencies that Adyen will process for this profile.                                                                                                                                                 |
   | SETTLEMENT BANK ACCOUNT | The bank account that receives the payouts from Adyen.                                                                                                                                                   |
   | PAYER AUTHENTICATION    | Enables [3D Secure 2 authentication](/online-payments/3d-secure/redirect-3ds2-3ds1).                                                                                                                     |
   | TEST MODE               | Uses Adyen test endpoints and environment. When used, this overrides the endpoint set in the **PRODUCTION ENDPOINT DOMAIN PREFIX** field of [Adyen SuitePayment Main Config](#suitepayment-main-config). |
   | INACTIVE                | Disables this payment processing profile.                                                                                                                                                                |

### Authentication Credentials

Enter the basic authentication [credentials](/development-resources/api-credentials#basic-authentication) and your API key from your [Customer Area](https://ca-test.adyen.com/) in the corresponding fields. Provide your Web Service User Name and Password in the username and password fields. You must enter your full Web Service User Name, for example **ws\@Company.\[YourCompanyAccount]**. Be aware that this field is case sensitive.

Netsuite doesn't pass null values to the backend. If you leave a previously filled out credential field blank, Netsuite will still pass the previous value.

### Adyen SuitePayment Main Config

| Field                               | Description                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| MERCHANT ACCOUNT ID                 | The name of your Adyen [merchant account](/account/account-structure/) for which the payments will be processed.                                                                                                                                                                                                                                                                                                         |
| PRODUCTION ENDPOINT DOMAIN PREFIX   | The prefix for your live URL. Get it from your [live Customer Area](https://ca-live.adyen.com/) > **Developers** > **API URLs** > **Prefix**. Example: **23tx059714e3400a-CompanyName**. Append **-pal-live** to the end of prefix. Example: **23tx059714e3400a-CompanyName-pal-live**. For a test environment, use only **pal-test** instead.                                                                           |
| []()CHECKOUT ENDPOINT DOMAIN PREFIX | The prefix for your live URL. Get it from your [live Customer Area](https://ca-live.adyen.com/) > **Developers** > **API URLs** > **Prefix**. Example: **23tx059714e3400a-CompanyName**. Append **-checkout-live** to the end of the prefix. Example: **23tx059714e3400a-CompanyName-checkout-live**. For a test environment, use only **checkout-test** instead. **Note: this field is mandatory for Hosted Checkout.** |
| FRAUD OFFSET                        | Adyen has its own [risk management](/risk-management) system to help you fight fraud. You can add a custom value to the Adyen risk score by entering it here.                                                                                                                                                                                                                                                            |
| SHOPPER INTERACTION OVERRIDE        | Specify the type of payments that you want to process through this profile. Possible values:- **Ecommerce**: if you are using [3D Secure 2 authentication](/online-payments/3d-secure).
- **MOTO**: if you are accepting payments by mail, fax, or phone.
- **POS**: if you are accepting point-of-sale payments.For all other transactions, leave this field blank.                                                     |
| KLARNA PAYMENT METHOD               | Select **Klarna - Pay Later** if you are accepting the Klarna Pay Later payment method.                                                                                                                                                                                                                                                                                                                                  |
| KLARNA ACCOUNTS PAYMENT METHOD      | Select **Klarna - Pay over time** if you are accepting the Klarna Pay over time payment method.                                                                                                                                                                                                                                                                                                                          |
| WECHAT PAYMENT METHOD               | Select **WeChat** if you are accepting the WeChat Pay payment method.                                                                                                                                                                                                                                                                                                                                                    |
| PAY BY LINK: PAYMENT METHOD         | Select the payment method you are using for pay by link.                                                                                                                                                                                                                                                                                                                                                                 |
| PAY BY LINK: TIMEOUT (HOURS)        | Your default timeout hours.                                                                                                                                                                                                                                                                                                                                                                                              |
| PAY BY LINK: BLOCKED METHODS        | Enter payment codes or brand codes of blocked payment methods. Separate each value with a comma. You can leave this field blank otherwise.                                                                                                                                                                                                                                                                               |
| PAY BY LINK: APPROVED METHODS       | If you limit Pay By Link to specific payment methods, enter the payment codes or brand codes. Separate each value with a comma. You can leave this field blank otherwise.                                                                                                                                                                                                                                                |

### Hosted Checkout customizations

Hosted Checkout pages pick up the customization you set for the Pay by Link [default theme](/unified-commerce/pay-by-link/create-payment-links/customer-area#themes).

Starting from February 13, 2023, the NetSuite plugin has migrated all payment methods using HPP to Hosted Checkout. If you were previously using HPP, you must add your [CHECKOUT ENDPOINT DOMAIN PREFIX](#checkout-endpoint) to your Payment Processing Profile in NetSuite.

### Payment information

* If you are creating a profile for cards, select the cards that you want to accept.
* If you are creating a profile for local payment methods, select **Adyen Alternative Payments**.
* If you are creating a profile for Pay by Link, select the created Pay by Link payment methods.
* If you are creating a profile for referenced or unreferenced refunds, select **Pay by Reference**.

### Gateway Request Types

Select **AUTHORIZATIONS**, **CAPTURES**, **SALES**, and **REFUNDS**.

## Set up SuiteCommerce Advanced

To set up your SuiteCommerce Advanced website:

1. Log in to your NetSuite Customer Center.
2. Go to **Commerce** > **Websites** > **Website List** > **New** > **Start Set Up (Suite Commerce Advanced)**.
3. On the **Shopping** tab, fill out the following fields:

| Field                                                   | Description                                                                                                                                                                                                                                                        |
| ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| PROCESS AN ONLINE PAYMENT WITH SALES ORDER CREATION     | Select **Enabled**.                                                                                                                                                                                                                                                |
| INCLUDE OUT OF STOCK ITEMS IN WEBSITE                   | Select **Enabled**.                                                                                                                                                                                                                                                |
| DROP SHIP/SPECIAL ORDER ITEMS ARE ALWAYS IN STOCK       | Select **Enabled**.                                                                                                                                                                                                                                                |
| PASS URL PROMOTION CODE TO CHECKOUT                     | Select **Enabled**.                                                                                                                                                                                                                                                |
| PRICES INCLUDE TAX                                      | Select **Enabled**.                                                                                                                                                                                                                                                |
| GIFT CERTIFICATE AFFECTS MINIMUM ORDER AMOUNT           | Select **Enabled**.                                                                                                                                                                                                                                                |
| SHIPPING INFORMATION IS REQUIRED                        | Select **Enabled**.                                                                                                                                                                                                                                                |
| DEFAULT WEBSITE SHIPPING METHOD                         | Select a preferred shipping method to be set as your default shipping method.                                                                                                                                                                                      |
| WEBSITE SHIPS TO ALL COUNTRIES                          | Select **Enabled**.                                                                                                                                                                                                                                                |
| DISPLAY PURCHASE ORDER FIELD ON PAYMENT INFO PAGE       | Select the checkbox to show a text field on your store's payment information page where customers can enter Purchase Order numbers. These numbers will automatically appear on [sales orders](/plugins/netsuite/#netsuite-glossary) generated from your web store. |
| DISPLAY 'SAVE MY CREDIT CARD INFO' FIELD                | Select **Enabled**.                                                                                                                                                                                                                                                |
| SAVE CREDIT CARD INFO BY DEFAULT                        | Select **Enabled**.                                                                                                                                                                                                                                                |
| HIDE PAYMENT PAGE IF ORDER TOTAL EQUALS ZERO            | Select the checkbox to hide the payment page during checkout if the order amount is equal to zero. This allows your shoppers to put items offered for free in their cart without being required to provide payment details.                                        |
| ALLOW NON-CREDIT CARD PAYMENT METHODS DURING CHECKOUT   | Select **Enabled**.                                                                                                                                                                                                                                                |
| RESTRICT PAYMENT METHODS BY CURRENCY OF A CUSTOMER      | Select the checkbox to only display the payment methods that support your shopper's currency on the payment page of your store.                                                                                                                                    |
| RESTRICT PAYMENT METHODS BY COUNTRY OF SHIPPING ADDRESS | Select the checkbox to only display the payment methods that support the country/region of the shipping address.                                                                                                                                                   |

## Set up 3D Secure for SuiteCommerce Websites

To enable 3D Secure payments for your SuiteCommerce website:

1. In NetSuite, go to **Commerce** > **Websites** > **Configuration**.
2. Select your website and domain, click **Configure**.
3. Go to the **Checkout** tab.
4. Select the **Enable 3D Secure Payments** checkbox.
5. Select **Save**.

## Set up email alerts

Email alerts inform you of exceptional transactions that require additional attention from your side. You can set up email alerts for:

* [Notification exceptions](#notification-exceptions): Orders that need to be manually updated in NetSuite.
* [Payment event exceptions](#payment-event-exceptions): Payments that were rejected.

### Notification exceptions

In extremely rare scenarios, for example when a [capture failed](/online-payments/capture/#failed-capture) after we sent it to the bank/third-party processor, a payment status change cannot be reflected in NetSuite. To keep your NetSuite and Adyen back ends synchronized, you need to *manually* update the order in NetSuite.

Though extremely rare, these scenarios may happen, and taking the appropriate action can be valuable to your business processing.

To receive emails informing you when a transaction needs to be manually updated:

1. Log in to your NetSuite Customer Center.

2. Go to **Transactions** > **Management** > **View Gateway Asynchronous Notifications**.

3. In the top-right corner of the page, select **Search**, and then **Create Saved Search**.

4. In the **Criteria** tab, in the **FILTER** list:

   * Select **Validate Postback Status** and set it to **any of:** **Accept**.

   * Select **Error** and set it to: **is not empty**.

   * Select **Date**, and set it to the period for which you'd like to receive the alerts.

     We recommend that you select **on** to: **today**.

5. Go to the **Email** tab:

   * In the **Specific Recipients** tab, enter the recipients for the scheduled emails.

   * Select the **SEND EMAILS ACCORDING TO SCHEDULE** checkbox.

   * In the **Schedule** tab, define the schedule for receiving the emails.

     We recommend using **DAILY EVENT**, in combination with either **Repeat every 1 day(s)**, or **Repeat every weekday**.

6. Select **Save & Run**.

### Payment event exceptions

To receive emails informing you when a transaction was rejected:

1. Log in to your NetSuite Customer Center.

2. Go to **Transactions** > **Management** > **View Payment Events**.

3. In the top-right corner of the page, select **Search**, and then **Create Saved Search**.

4. In the **Criteria** tab, in the **FILTER** list:

   * Select **Payment Event Result** and set it to **any of**: **Reject** and **Payment Hold**.
   * Select **Payment Event Date** and set it to the period for which you'd like to receive the alerts.

5. Go to the **Email** tab:

   * In the **Specific Recipients** tab, enter the recipients for the scheduled emails.
   * Select the **SEND EMAILS ACCORDING TO SCHEDULE** checkbox.
   * In the **Schedule** tab, define the schedule for receiving the emails.

6. Select **Save & Run**.

## See also

* [Adyen account structure](/account/account-structure)
