Skip to main content
Welcome to the preview portal — This is an early release of the new Doc Hub experience, with more content coming soon.
Technology Partner

Configure the Oracle NetSuite SuiteApp


You manage the configuration from the SuiteApp user interface, under Configuration > SuiteApp. Three steps are required before the SuiteApp can process a payment:

  1. Create supported Payment Methods.
  2. Map the Payment Methods.
  3. Create a Payment Processing Profile.

Complete all three steps before processing a production transaction. The first two steps are covered below; the Payment Processing Profile is covered in its own reference page, linked at the end of this section.

Create a Payment Method Automatically

The automatic option creates and maps the payment methods that the SuiteApp supports.

To create supported payment methods automatically, choose Configuration > SuiteApp > Step 1. Payment Method > Create Supported Payment Methods (Automatic).

This option creates card payment methods, ACH and eCheck payment methods, and token payment methods. It also maps the payment methods automatically. Any additional payment methods must be created manually. See Create a Payment Method Manually.

Create a Payment Method Manually

Create a payment method manually when you need one that the automatic option does not create.

Follow these steps to create a payment method manually:

  1. To create a payment method manually, choose Configuration > SuiteApp > Step 1. Payment Method > Create Payment Method (Manual).

  2. In the Payment Method Name field, enter a name.

  3. In the Type field, choose the appropriate option:

    • For a credit or debit card payment method, choose the appropriate card brand.
    • For Order Management operations only, choose External Checkout.

    If you want NetSuite to pass line-level data in payment messages, select Requires Line Level Data.

  4. Click Save.

  5. Repeat the procedure for any additional payment methods.

  6. Proceed to Map the Payment Method.

Map the Payment Method

Each payment method must be mapped to ensure proper processing in the SuiteApp.

If you selected automatic creation of the payment methods, and do not need to add any additional payment methods, you can skip this step.

Follow these steps to manually add payment methods:

  1. From the menu, choose Configuration > SuiteApp > Step 2. Payment Method Mapping > Map Payment Methods. The payment methods that are available for mapping are listed.
  2. Choose a payment method and click Edit.
  3. In the Payment Name field, enter a name and click Save. Repeat this process for any additional payment methods that need to be mapped.

Create a Payment Processing Profile

After you create and map your payment methods, you must create a Payment Processing Profile — this is where you configure the merchant ID, REST key, supported payment methods, and gateway request types that let the SuiteApp actually process a transaction. The SuiteApp cannot process payments until a Payment Processing Profile is configured. See Payment Processing Profile to complete this required step.

Map Merchant Defined Data Fields

This step is optional. Complete it only if you use Decision Manager and want to pass merchant-defined data fields to it.

You can create and configure Merchant Defined Data mapping records for the SuiteApp.

To create a Merchant Defined Data mapping record, follow these steps:

  1. From the SuiteApp menu, choose Integration > Merchant Defined Data Mapping Records > Map Merchant Defined Data Fields.
  2. On customdeploy_cs_pymt_map_mdd_mapping_od, click Edit to open the record.
  3. From the Save drop-down menu, click Save and Execute. This action creates the Merchant Defined Data records.
  4. To view the Merchant Defined Data records you created, from the menu choose Integration > Merchant Defined Data Mapping Records > View Merchant Defined Data Fields.

Additional Configuration

These features are optional. See these reference pages to configure them:

Last published: November 18, 2026