Search

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 terminals: M400, V400c, V400m, P400 Plus, e285.

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 a ws user

For connecting your NetSuite back end to the Adyen API, you need to have a web service (ws) user. If you have several merchant accounts for your POS processing, you can associate them to a single ws user.

To set up a ws user:

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

    1. In the API key section, click 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
    • Submit POS payments
  6. Associate the correct merchant accounts to the ws user.
  7. Click 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 click 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 Check to use Adyen test endpoints. If checked, this overrides the endpoint that you enter in the PRODUCTION ENDPOINT DOMAIN PREFIX below.
INACTIVE Check to disable this payment processing profile.

Authentication Credentials

Enter the username and basic authentication password for the ws user 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.
SHOPPER INTERACTION OVERRIDE Select: POS
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, click Edit.
  3. In the DEVICE ID box, enter the unique terminal ID of your Adyen POS 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 . This opens the quick info menu, and displays the serial number.

  4. Under SUPPORTED PAYMENT METHOD, select Adyen EMV.
  5. Click 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 Settings > Server Communication.
  5. Next to Terminal API Notification, click Add.
  6. In the URL box, enter the POSTBACK URL that you copied from NetSuite.
  7. Check the Active checkbox.
  8. Click 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 > Global properties.
  3. Go to the Terminal API tab.
  4. In the event URLs box, enter: ["YOUR_POSTBACK_URL_FROM_NETSUITE"]
    Example: ["https:\/\/system.netsuite.com\/payments\/postback?compid=TSTDRV1919617&nlm ..."]
  5. Click Save at the bottom of the page.

See also