Set up point of sale

Before you begin

• Install the NetSuite Chargeback Workflow Bundle, and the Adyen SuitePayments Bundle.
• Make sure that your local network allows your cash register and payment terminal to connect to a network. For more information, refer to our point-of-sale network recommendations.

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 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. Navigate 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:

   6. 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.

   7. 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:

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

• 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 . 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 > Global properties.
3. Go to the Terminal API tab.
4. In the event URLs field, enter: ["YOUR_POSTBACK_URL_FROM_NETSUITE"]
   Example: ["https:\/\/system.netsuite.com\/payments\/postback?compid=TSTDRV1919617&nlm ..."]
5. Select Save at the bottom of the page.

See also