To set up the Adyen plugin for NetSuite:
- Install the Adyen payments bundles.
- Create a payment method instance.
- Create a payment processing profile.
- (Optional) Set up email alerts: receive emails informing you of transactions that require additional attention.
Install the Adyen payments bundles
Step 1: Install the NetSuite Chargeback Workflow Bundle
This module directly supports the chargeback processing and the notification system, where financial transactions and related updates are being received by NetSuite on a schedule determined by outside systems. The notifications listener is active at all times and chargeback notifications are received and shown on the Notifications main listing for user review.
To install this bundle:
- Log in to your NetSuite Customer Center.
- Go to Customization > SuiteBundler > Search & Install Bundles.
- Search for the Chargeback Workflow Bundle (ID: 127355).
- Select Install.
To view your chargebacks in the NetSuite Customer Center, go to Transactions > Management > View chargeback notifications.
Step 2: Install the ADYEN - SuitePayments Bundle
Before you begin, make sure that you have installed the NetSuite Chargeback Workflow Bundle in Step 1.
This module directly supports payment processing between NetSuite clients and Adyen, allowing you to accept:
- Credit cards
- Local payment methods (such as iDEAL or Sofort) using Adyen hosted payment pages (HPP).
To install this bundle:
- Log in to your NetSuite Customer Center.
- Go to Customization > SuiteBundler > Search & Install Bundles.
- Search for the ADYEN - SuitePayments Bundle.
- Select Install.
- After the installation is complete, go to Customization > Plug-ins > Manage Plug-ins.
- Check ADYEN SUITEPAYMENTS IMPLEMENTATION to activate the bundle.
Create a payment method instance
The payment method instances define which payment methods and token types are available for a payment processing profile.
If you are accepting payments with cards, local payment methods (HPP), Klarna, and WeChat Pay, you need to create a separate payment method instance for each.
You need to create a separate payment method instance for each of the following type of payment you accept:
If you want to use tokenization in NetSuite, you also need to specify which token type to use:
Cards
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Accounting Lists > New.
- Select Payment method.
- Set TYPE to Payment Card.
- Select the DISPLAY IN WEB SITE checkbox.
Local payment methods (HPP)
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Accounting Lists > New.
- Select Payment method.
- Set TYPE to External Checkout.
- Select the DISPLAY IN WEB SITE checkbox.
Klarna and WeChat Pay
You need to create a separate payment method instance for each payment method you are accepting. Klarna Pay Later and Klarna Pay over time are different payment methods.
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Accounting Lists > New.
- Select Payment method.
- Set TYPE to External Checkout.
- Select the DISPLAY IN WEB SITE checkbox.
- For Klarna payment methods, select the REQUIRES LINE-LEVEL DATA checkbox.
- Go to Payment Visuals and fill out the FLAGS and URL fields.
- FLAGS: the flags used to refer to the image for this payment method on your site. If you are using a SiteBuilder website, enter web/standard. If you are using a SuiteCommerce Advanced site, use any flag that your code uses to refer to the image.
- URL: the URL for the image for this payment method on your site.
Pay By Link
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Accounting Lists > New.
- Select Payment method.
- Set TYPE to External Checkout.
- Set ASSOCIATED PROCESSING PROFILES to the payment profile you use with Adyen.
Card token
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Accounting Lists > New.
- Select Payment method.
- Set TYPE to Payment Card Token.
General token
- Log in to your NetSuite Customer Center.
- Go to Setup > Accounting > Accounting Lists > New.
- Select Payment method.
- Set TYPE to Payment General Token.
Create a payment processing profile
A payment processing profile can process payments in multiple currencies, but can only settle in one currency and to one bank account. Therefore, you need to create a separate payment processing profile for each currency in which you want to be settled in.
Additionally, we recommend that you create a separate payment processing profile for:
- credit cards and local payment methods (HPP).
- each NetSuite subsidiary that uses Adyen for payment processing.
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 |
|---|---|
| WEB SITE | Select the websites that you want to configure for this profile. |
| 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. |
| PAYER AUTHENTICATION | Enables 3D Secure. |
| TEST MODE | Uses Adyen test endpoints and environment. When used, this overrides the endpoint set in the PRODUCTION ENDPOINT DOMAIN PREFIX field of Adyen SuitePayment Main Config. |
| INACTIVE | Disables this payment processing profile. |
Authentication Credentials
Enter the basic authentication credentials and your API key from your Adyen Customer Area in the corresponding fields. Provide your full Web Service User Name in the user field, for example ws@Company.[YourCompanyAccount]. Be aware that this field is case sensitive.
Netsuite doesn't pass null values to the backend. If you leave a previously filled out credential field blank, Netsuite will still pass the previous value.
Adyen SuitePayment Main Config
| Field | Description |
|---|---|
| MERCHANT ACCOUNT ID | The name of your Adyen merchant account for which the payments will be processed. |
| PRODUCTION ENDPOINT DOMAIN PREFIX | The live URL prefix [random]-[company name]-pal-live. For more information, refer to Live endpoints. Example: 23tx059714e3400a-CompanyName-pal-live. For a test environment specify pal-test. |
| CHECKOUT ENDPOINT DOMAIN PREFIX | The live URL prefix [random]-[company name]-checkout-live. For more information, refer to Live endpoints. This field is necessary for Pay by Link. Example: 23tx059714e3400a-CompanyName-checkout-live. For a test environment specify pal-test. |
| FRAUD OFFSET | Adyen has its own risk engine to help you fight fraud. You can add a custom value to the Adyen risk score by entering it here. |
| SHOPPER INTERACTION OVERRIDE | Specify the type of payments that you want to process through this profile. Possible values:
|
| KLARNA PAYMENT METHOD | Select Klarna - Pay Later if you are accepting the Klarna Pay Later payment method. |
| KLARNA ACCOUNTS PAYMENT METHOD | Select Klarna - Pay over time if you are accepting the Klarna Pay over time payment method. |
| WECHAT PAYMENT METHOD | Select WeChat if you are accepting the WeChat Pay payment method. |
| PAY BY LINK: PAYMENT METHOD | Select the payment method you are using for pay by link. |
| PAY BY LINK: TIMEOUT (HOURS) | Your default timeout hours. |
| PAY BY LINK: BLOCKED METHODS | Enter payment codes or brand codes of blocked payment methods. Separate each value with a comma. You can leave this field blank otherwise. |
| PAY BY LINK: APPROVED METHODS | If you limit Pay By Link to specific payment methods, enter the payment codes or brand codes. Separate each value with a comma. You can leave this field blank otherwise. |
Hosted payments page options
The following fields are only required if you are accepting local payment methods (using HPP).
| Field | Description |
|---|---|
| SKIN CODE | The skin code from you Adyen Customer Area. |
| ALLOW SKIP PAYMENT PAGE | With our HPP integration, the shopper is redirected to an Adyen hosted payment page to select their payment method. Select this field to have the payment process take place within a single page. |
| MULTI PAGE | With our HPP integration, the shopper is redirected to an Adyen hosted payment page to select their payment method. Select this field to split the payment process into several pages. |
| SESSION VALIDITY | Enter the time (in seconds) within which the payment has to occur. This is useful for tickets and reservations, where you want to hold items for sale for a short period of time.
|
| HMAC KEY ENTRY | Enter The HMAC key for the skin from your Adyen Customer Area. |
| CHECKOUT API KEY ENTRY | If you offer Pay by Link, enter the API Key from your Adyen Customer Area. Otherwise, leave this empty. |
Payment information
- If you are creating a profile for cards, select the cards that you want to accept.
- If you are creating a profile for local payment methods, select Adyen Alternative Payments.
Gateway Request Types
Select AUTHORIZATIONS, CAPTURES, SALES, and REFUNDS.
Set up email alerts
Email alerts inform you of exceptional transactions that require additional attention from your side. You can set up email alerts for:
- Notification exceptions: Orders that need to be manually updated in NetSuite.
- Payment event exceptions: Payments that were rejected.
Notification exceptions
In extremely rare scenarios, for example when a capture failed after we sent it to the bank/third-party processor, a payment status change cannot be reflected in NetSuite. To keep your NetSuite and Adyen back ends synchronized, you need to manually update the order in NetSuite.
Though extremely rare, these scenarios may happen, and taking the appropriate action can be valuable to your business processing.
To receive emails informing you when a transaction needs to be manually updated:
- Log in to your NetSuite Customer Center.
- Go to Transactions > Management > View Gateway Asynchronous Notifications.
- In the top-right corner of the page, select Search, and then Create Saved Search.
- In the Criteria tab, in the FILTER list:
- Select Validate Postback Status and set it to any of: Accept.
- Select Error and set it to: is not empty.
- Select Date, and set it to the period for which you'd like to receive the alerts.
We recommend that you select on to: today.
- Go to the Email tab:
- In the Specific Recipients tab, enter the recipients for the scheduled emails.
- Select the SEND EMAILS ACCORDING TO SCHEDULE checkbox.
- In the Schedule tab, define the schedule for receiving the emails.
We recommend using DAILY EVENT, in combination with either Repeat every 1 day(s), or Repeat every weekday.
- Select Save & Run.
Payment event exceptions
To receive emails informing you when a transaction was rejected:
- Log in to your NetSuite Customer Center.
- Go to Transactions > Management > View Payment Events.
- In the top-right corner of the page, select Search, and then Create Saved Search.
- In the Criteria tab, in the FILTER list:
- Select Payment Event Result and set it to any of: Reject and Payment Hold.
- Select Payment Event Hold Reason and set it to is not: Operation was successful.
- Select Payment Event Date and set it to the period for which you'd like to receive the alerts.
- Go to the Email tab:
- In the Specific Recipients tab, enter the recipients for the scheduled emails.
- Select the SEND EMAILS ACCORDING TO SCHEDULE checkbox.
- In the Schedule tab, define the schedule for receiving the emails.
- Select Save & Run.