Configuring EMV Payment Services for SCIS

This topic applies to

Applies to

SuiteCommerce InStore


EMV is the standard for chip card technology. SuiteCommerce InStore (SCIS) supports in-store technology used for processing payments made with smart-chip cards. To configure support for EMV, you must first install a SuiteApp distributed by a Payment Service Provider (PSP) that supports integration with NetSuite. Next, create a payment processing profile and payment method in NetSuite, and then configure related SCIS custom records.

To configure EMV payment services for SCIS:

  1. Go to Setup > Accounting > Accounting Preferences.

  2. Click the Items/Transactions subtab. Check the following boxes under Payment Processing:

    • Use Strict Rules for the Selection of Payment Processing Profiles.

    • Preserve Transactions When Payment is On Hold.

  3. Install the Moneris EMV Payment Processing SuiteApp, bundle ID 122131.

  4. Create a Payment Method in NetSuite flagged as EMV.

    1. Go to Setup > Accounting > Accounting Lists.

    2. Create a new Payment Method. Name it for the payment processing solution you plan to use.

    3. Check the EMV box.

    4. Click Save.

  5. Set up a payment processing profile in NetSuite for your Payment Service Provider. Go to Setup > Accounting > Payment Processing Profiles.

    1. In the Primary section, complete the information as appropriate.

    2. In the Authentication Credentials section, enter the account information provided by the payment service provider.

    3. Under Payment Information, select the payment methods you want to process with this profile.

    4. In the Gateway Request Types section, select the requests this profile supports.

  6. Create an SCIS Payment Method custom record.

    1. Go to Customization > Record Types > SCIS Payment Method > List.

    2. Click New SCIS Payment Method.

    3. In the Payment Method field, select the EMV payment method you created in Step 3.

    4. Check the Is Main box.

    5. Complete other fields on this page as needed. For more information on creating SCIS payment methods, see SCIS Payment Method Records.

    6. Click Save.

  7. Define SCIS Payment Devices. This custom record identifies the device you plan to use to process the EMV payment type.

After an administrator has configured all the components above to support EMV transactions, a new button appears in the Transaction Summary area on the main SCIS screen. The sales associate clicks this button to process orders paid with a smart-chip card. If you have configured multiple EMV devices, they can be selected from a list that displays after the EMV button is clicked. If the customer’s signature is required, it is applied to the receipt and saved on the transaction record in NetSuite.

EMV Error Handling – When an Invoice Fails to Save

EMV credit card payments include behind–the-scenes steps that save an invoice in NetSuite. When an invoice failure occurs, SCIS attempts to automatically refund the customer’s payment back to their credit card. The error-handling process alerts the sales associate to the payment error and lists whether the refund to the card was successful.

For the automatic refund to occur, the EMV payment must have included a Payment Number Reference (PNRF) that enables a refund without the physical credit card. Some Payment Processing Profiles provide a PNRF for payment transactions, while others do not.

If an automatic refund fails, the alert states that the refund must be processed manually. Manual refunds are performed in NetSuite by your administrator.


The customer’s payment must be refunded before the sales associate can attempt to take payment again

  • Customer payment was automatically refunded — This alert means that no action is needed from the sales associate for the refund.

    The associate should:

    1. Tap Return to Cart

    2. Try submitting the payment again.

    3. If the error continues to happen, the associate should ask their store manager to report the error to the system administrator.

  • You must manually refund the payment — The automatic refund failed to complete. An administrator must process the refund in NetSuite before the sales associate can complete the transaction.

    1. The sales associate will notify their store manager, who will contact the system administrator. The administrator will:

      1. Log into NetSuite.

      2. Find the customer’s payment and refund their credit card.

        See the help topic Refunding an Open Balance.

      3. Notify the store manager when the refund is complete.

    2. When notified by the manager that the refund has been made, the sales associate will::

      1. Tap Return to Cart.

      2. Try submitting the payment again.

      3. If the error continues to happen, they will notify the store manager and ask for instructions on how to proceed with the customer.

If notified by the store manager that the error continues to occur, the administrator should contact NetSuite Customer Support for assistance.


Failure to save an invoice is not due to an issue with the credit card. The customer can try to pay again using the same card, a different card, or another payment method, such as cash.

SCIS Payment Device Custom Records

After you have completed setting up EMV payment services, you must configure payment devices in SCIS for use with EMV. Define each device by configuring an SCIS Payment Device record. You must configure an SCIS Payment Device record to support each EMV device at each location.

To configure an SCIS Payment Device:

  1. Go to Customization > Record Types > SCIS Payment Device > List.

  2. Click New SCIS Payment Device.

  3. In the Name field, enter a name for the device. Enter a name that you can use to identify the device, for example, Device–1234.

  4. Enter the Device ID. This value is commonly an IP or an unique value the payment processor uses to communicate with the device.

  5. In the Supported Payment Method list, select the EMV payment method supported on the device.

  6. Select the Locations that can use this payment device. You can select one or more options in the list.

  7. Click Save.

After you have configured the SCIS payment device record, test the device. When the sales associate chooses a particular payment method in SCIS, a popup list shows the payment devices that have been configured. The sales associate then selects a payment device to continue.