Are you looking for test card numbers?

Would you like to contact support?

Plugin icon

Set up point of sale

Configure SuiteCommerce InStore (SCIS) for processing point-of-sale (POS) payments with Adyen.

Before you begin

Our SCIS integration supports the following payment terminals:e280, e285, M400, P400 Plus, V400c, and V400m.

Step 1: Set up your Adyen Customer Area

We recommend creating a separate Adyen merchant account for your POS processing. If you operate multiple physical stores, you can link these to one merchant account, using the storeID to identify the individual store location.

Set up API credentials

For connecting your NetSuite back end to the Adyen Terminal API, you need to have API credentials. If you have several merchant accounts for your POS processing, you can associate them to a single API credential.

  1. Log in to the Adyen Customer Area with your company-level account.
  2. Go to Account > API credentials.
  3. If you don't have an API credential yet, select Add new credential, and select Webservice as User type.
    If you already have one, click on this user in the API credentials list.
  4. In the Authentication pane:

    1. In the API key section, select Generate New API Key.

      Securely store the API key in your system. You'll need this to create a payment processing profile in NetSuite, and won't be able to restore it later.

    2. From the Basic Auth section, note down the password.

      Securely store the basic authentication password in your system. You'll need this to create a payment processing profile in NetSuite, and won't be able to restore it later.

  5. In the Roles and Associated Accounts pane, enable the following roles:
    • API PCI Payments Role

      To enable the API PCI payments role, contact our Support Team, and mention that you are using NetSuite.

    • Merchant PAL Webservice Role.
    • Checkout webservice Role
  6. Associate the correct merchant accounts to the API credential.
  7. Select Save at the bottom of the page.

The API key and the basic authentication password will only take effect after you save the configuration.

Step 2: Set up your NetSuite Customer Center

To set up POS processing in NetSuite:

  1. Create a payment method instance.
  2. Create a payment processing profile.
  3. Set up device IDs.

Create a payment method instance

You need to set up a separate payment method instance for processing POS payments:

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

Create a payment processing profile

Your POS implementation needs its own payment processing profile. 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
    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.
    TEST MODE Use Adyen test endpoints. If selected, this overrides the endpoint that you enter in the PRODUCTION ENDPOINT DOMAIN PREFIX below.
    INACTIVE Disable this payment processing profile.

Authentication Credentials

Enter the username and basic authentication password that you set up in your Adyen Customer Area in Step 1.

Adyen SuitePayment Main Config

Field Description
MERCHANT ACCOUNT ID The name of your Adyen merchant account for which the POS payments will be processed.
PRODUCTION ENDPOINT DOMAIN PREFIX The live URL prefix from your Customer Area > Account> API URLs > Point of Sale.

Example: https://pos-payment-test.

This field is not used when you checked TEST MODE above.
CHECKOUT API KEY ENTRY Enter the API key from your Adyen Customer Area.
  • In the Payment information section, select Adyen EMV.
  • In the Gateway Request Types section, check AUTHORIZATIONS, CAPTURES, SALES, and REFUNDS.

Set up device IDs

Every payment terminal that you are using with Adyen needs to be registered in NetSuite:

  1. In your NetSuite Customer Center, search for SCIS payment device.
  2. Next to New SCIS Payment Device, select Edit.
  3. In the DEVICE ID box, enter the unique terminal ID of your Adyen payment terminal.
    You can find this in the Adyen Customer Area, under Point-of-sale >Terminals

    The unique terminal ID =[Device model]-[Serial number], for example: P400Plus-123456789.

    You can also find the serial number of your terminal: press 5 on the terminal, and then press Confirm . This opens the quick info menu, and shows the serial number.

  4. Under SUPPORTED PAYMENT METHOD, select Adyen EMV.
  5. Select Save at the top-left corner of the page.

Step 3: Set up notifications

To inform NetSuite of payment status changes, Adyen uses notifications, sent as HTTP callbacks (webhooks) to endpoints on your server. To receive notifications, you need to enter in your Adyen Customer Area the postback URL for your payment processing profile in NetSuite:

  1. In your NetSuite Customer Center, go to your POS payment processing profile in View mode.
  2. In the Payment Information section, copy the POSTBACK URL.
  3. Log in to your Adyen Customer Area, and switch to your POS merchant account.
  4. Go to Account > Server Communication.
  5. Next to Terminal API Notification, select Add.
  6. In the URL box, enter the POSTBACK URL that you copied from NetSuite.
  7. Select the Active check box.
  8. Select Save Configuration at the bottom of the page.

You also need to enter the postback URL in the Terminal API settings:

  1. Log in to your Adyen Customer Area, and switch to your POS merchant account.
  2. Go to Point of sale > Terminal settings.
  3. Go to the Integrations tab.
  4. Under Terminal API, in the Event URLs field, enter: ["YOUR_POSTBACK_URL_FROM_NETSUITE"]
    Example: ["https:\/\/\/payments\/postback?compid=TSTDRV1919617&nlm ..."]
  5. Select Save at the bottom of the page.

See also