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.
- Log in to the Adyen Customer Area with your company-level account.
- Navigate to Account > API credentials.
- 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. -
In the Authentication pane:
- 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.
- 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.
- In the API key section, select Generate New API Key.
- 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
- API PCI Payments Role
- Associate the correct merchant accounts to the API credential.
- 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:
Create a payment method instance
You need to set up a separate payment method instance for processing POS payments:
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Accounting Lists > New.
- Select Payment method.
- Set TYPE to EMV.
Create a payment processing profile
Your POS implementation needs its own payment processing profile. To create a payment processing profile:
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Payment Processing Profiles > New.
- 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. |
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:
- In your NetSuite Customer Center, search for SCIS payment device.
- Next to New SCIS Payment Device, select Edit.
- 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.
- Under SUPPORTED PAYMENT METHOD, select Adyen EMV.
- 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:
- In your NetSuite Customer Center, go to your POS payment processing profile in View mode.
- In the Payment Information section, copy the POSTBACK URL.
- Log in to your Adyen Customer Area, and switch to your POS merchant account.
- Go to Account > Server Communication.
- Next to Terminal API Notification, select Add.
- In the URL box, enter the POSTBACK URL that you copied from NetSuite.
- Select the Active check box.
- Select Save Configuration at the bottom of the page.
You also need to enter the postback URL in the Terminal API settings:
- Log in to your Adyen Customer Area, and switch to your POS merchant account.
- Go to Point of sale > Global properties.
- Go to the Terminal API tab.
- In the event URLs field, enter: ["YOUR_POSTBACK_URL_FROM_NETSUITE"]
Example: ["https:\/\/system.netsuite.com\/payments\/postback?compid=TSTDRV1919617&nlm ..."] - Select Save at the bottom of the page.