Payment Instruments

The Payment Instruments feature makes using various payments methods more straightforward and, in the case of payment cards, more secure. Payment instruments provide a set of fields that can be used to charge a shopper without any action on the shopper's side.

The shopper does not have to take any action when, for example, the Card on File box was previously checked, or a token that represents a payment card was previously created.

Use Payment Instruments only with payment gateways that are natively integrated with NetSuite.

Payment Instruments are enabled by default on new accounts.

Benefits of Payment Instruments

The Payment Instruments feature provides the following benefits:

Considerations Before Enabling Payment Instruments

The Payment Instruments feature provides new records, which may disrupt integrations with third-party commerce solutions. Previously, importing credit cards was sensitive with regards to PCI compliance. If supported by your gateway vendor, the new design enables you to import tokens that represent credit cards. The tokens are stored with your gateway service. Using credit card tokens diminishes PCI data security concerns.


Importing credit card data after enabling the Payment Instruments feature disrupts your integration. You must map the imported credit card data to the new Payment Card record.

You must use SuiteCommerce or SuiteCommerce Advanced 2019.1 or later with tokenized payment instruments. Using tokenized payment instruments with SuiteCommerce or SuiteCommerce Advanced requires templates included in SuiteCommerce Base Theme version 2019.1 or later.

Tokenized payment instruments are not supported on SiteBuilder Extensions.

Enabling the Payment Instruments Feature

Prerequisite: before you can enable the Payment Instrument feature, you must first enable the Credit Cards Payments feature on your account.

To enable the Payment Instruments feature:

  1. Go to Setup > Company > Enable Features.

  2. Click the Transactions subtab.

  3. Check the Payment Instrument box.

  4. Click Save.

Creating a Payment Instrument Manually on a Customer Record

After enabling the Payment Instruments feature, you can create a payment instrument for the customer.

To create a payment instrument manually for a specific customer:

  1. Search the customer's name in the search field, or go to Lists > Relationships > Customers, and select the customer you want to create a new payment instrument for.

  2. Click the Financial subtab, then click the Payment Instruments subtab.

  3. Click New.

  4. In the Primary Information section, select the desired payment instrument from the Type list. A different set of field becomes available after selecting either a General Token or Payment Card Token.

  5. Fill out the fields on the payment instrument page

  6. Click Save.

Related topics:

General Notices