Setup

Complete the following steps to configure your BlueSnap Global Payments for NetSuite integration. You can also leverage BlueSnap IPNs (webhooks) so you can receive real-time information about your NetSuite transaction events.

Prerequisites

Before you begin, you must have accounts at both NetSuite and BlueSnap:
 Visit NetSuite to sign up.
 Visit BlueSnap to get started.

Step 1: Configure BlueSnap account settings

Complete these steps in your Merchant Portal(production or sandbox).

  1. Get your BlueSnap API credentials and define the authorized IP addresses for your server. Both of these actions are performed on the same page. For instructions, see API Credentials.

  2. Set up your statement descriptor. The statement descriptor is the description that appears on the shopper's credit card statement or bank statement for each transaction and helps the shopper identify the transaction.

  • Go to Settings > General Settings.
  • In the Branding Settings section, enter a Default Statement (Soft) Descriptor and Support Phone Number (both appear on the shopper's statement).
  • Click Submit.
  1. To get paid, you need to configure your payout settings. Refer to Payout for more information.
  2. You can select specific payment methods through the BlueSnap Merchant Portal. Refer to Enabling Payment Methods for more information.
  3. You can set up email notifications for yourself or your shoppers. Learn more.

Step 2: Install and configure BlueSnap Global Payments for NetSuite

Complete these steps in your NetSuite account to install and configure the BlueSnap bundle.

  1. Enable Required Features
    1. Go to Setup > Company > Enable Features
    2. Under Transactions, check the box next to Payment Instruments to enable it.
    3. Under SuiteCloud, check the boxes next to Custom Records and Server SuiteScript to enable those features.
    4. Under CRM, check the box next to Customer Relationship Management to enable it.
  2. Install BlueSnap Global Payments for NetSuite
    1. Navigate to the SuiteApp Marketplace using the search bar or tabs at the top of the page.
    2. Search for "BlueSnap".
    3. Click the BlueSnap Global Payments for NetSuite bundle and click Install.
      Note: The installation may take a few moments.
  3. Enable BlueSnap
    1. Go to Customization > Plug-ins > Manage Plug-ins.
    2. Check the box next to BlueSnap Plugin to enable it.
  4. Setup Payment Profile
    1. Go to Setup > Accounting > Payment Processing Profiles > New.
    2. Enter a Name for your profile. Keep in mind you can create multiple payment profiles.
    3. Select a Subsidiary.
    4. Under Charge Currency, select one or multiple currencies based on which currencies you want to charge shoppers in.
    5. Select the check boxes next to the following required features to enable them:
      • Support Line-Level Data
      • Payer Authentication
      • Test Mode (must be checked off only if connecting to a BlueSnap sandbox account)
    6. Enter your BlueSnap API Credentials:
      1. BlueSnap User Key: Enter your BlueSnap API user key for production (or sandbox for testing purposes).
      2. BlueSnap Password: Enter your BlueSnap API password for production (or sandbox for testing purposes).
    7. You can define your Soft Descriptor within NetSuite and this value will be included in all transactions. You can also leave the field blank and the descriptor set within BlueSnap account will be used instead.
    8. Select which payment methods you want to enable from the list of Supported Payment Methods. Choosing a payment method other than cards and ACH will open a new page for your customer to complete their order.
    9. Click Save.

Step 3: Setup IPNs in BlueSnap

  1. From your Payment Processing Profile in NetSuite, copy the postback URL.
  2. In BlueSnap, follow our IPN setup documentation to enable notifications. When you reach Step 2, use the postback URL you copied from NetSuite as an IPN URL in BlueSnap.

You may receive the Decline, Chargeback, Chargeback Status Changed, and Refund IPNs.

Step 4: Require line-level data for payment methods

For each payment method enabled under Setup > Accounting > Accounting Lists in Step 2, select the checkbox next to the Requires Line-Level Data setting to enable it.