Introduction

...

1. threed_secure_referenceId - The threed_secure_referenceId is a unique identifier created as part of a BlueSnap 3DS transaction. If the threed_secure_referenceId is provided in the payment gateway request, the ONTI can be retrieved. If no ONTI is found in the table, the NTI is used.

2. transaction_id - If the threed_secure_referenceId is not available, the transaction_id created by the payment gateway can be used to search for the ONTI and used in the request. If the ONTI is not found, the NTI is used. If neither the ONTI nor NTI are found for the transaction_id, nothing is provided to BlueSnap.

Setting Up the International Gateway

1. Register with BlueSnap - BlueSnap will contact you directly when the application is approved or if additional information is required.

2. Create BlueSnap API Credentials - You will need to create API credentials and set up 3DS2.

3. Provide the API Credentials to MerchantE - Customer Care will then create an account change request to add the information to your profile.

   1. help@merchante.com

   2. 1-888-288-2692

4. Contact MerchantE Sales EngineeringEngineering. Sales Engineering will help you complete and test the settings.

   1. help@merchante.com

   2. 1-888-288-2692

Registering with BlueSnap

To use the international gateway, you will first have to register with BlueSnap.

1. Sign up using the BlueSnap Application Portal.

   1. https://sandbox.bluesnap.com/jsp/referred_onboarding/?referral=MERCHANTE1

   2. For subsequent visits, login to your account.

2. Click the Account Application tile to start the application process.

3. Fill out the application.

   1. Business Info:

      1. Country - Select the country of origin.

      2. Email - Add a contact email for the business.

      3. Business Name (Doing Business As) - The informal name of the business.

      4.  Business Legal Name - The legal name of the business.

      5. Website - The business website.

      6. Address - Street address, city, state, and postal code for the business.

      7.  Phone - Business contact phone number.

      8.  Click Next.

   2. Processing Info:

      1. Product and Services Description - Keywords describing the goods and services provided.

      2.  Business Entity - Structure of the business.

      3. Product Description - Category for the goods and services.

      4. Sales Volume ($)

      5. Tax ID - Tax identification number for the business.

      6. Click Next.

   3. Ownership Info:

      1. Country - Company representative’s country of citizenship.

      2. First Name - Company representative’s first name.

      3. Last Name - Company representative’s last name.

      4. Date of Birth - Company representative’s date of birth.

      5. Address - Company representative’s street address, city, state, and postal code.

      6. Phone - Contact phone number for the company representative.

      7. Number of Owners - Number of owners who own more than 25% of the business.

      8. Click Next.

   4. Banking Info:

      1. Bank Account State - Location of the Bank.

      2. Account Type - Checking or Savings account.

      3. Bank Name - Name of the bank.

      4. Routing Number - Account routing number.

      5. Account Number - Account number.

      6. Click Complete.

BlueSnap Merchant Account Setup

To use the international gateway, you will need to complete the account setup after BlueSnap approves the account registration. This includes setting up:

• API Credentials

• 3DS2 Support Options

API Credentials

1. Navigate to the URL provided in the welcome email.

2. Open the Settings menu and select API Settings.

3. API Credentials - Set a password and click Request API credentials.

4. Provide the Username and Password in the API Credentials section to MerchantE.

Completing Your International Gateway Setup

Completing your setup depends on how the international gateway will be used.

• If you are using NetSuite, follow the instructions to set up your NetSuite account to use the international gateway. You will need to enable features in your Payment Processing Profile to use 3DS2 transactions and select the currencies that will be used for transactions.

• If you are not using NetSuite, additional development work will be necessary depending on your specific implementation. You will need to send the fields specified in the Non-NetSuite section.

3DS2 Transactional Parameters

1. Navigate to the URL provided in the welcome email.

2. Open the Settings menu and select Fraud Settings.

3. Use the Fraud Settings page to customize your support. For more information, see Fraud Prevention.

4. The 3D Secure rules section can be used to customize your 3DS2 support.

NetSuite

You will need to configure your Payment Processing Profile to use the International Gateway in NetSuite.

The MerchantE SuitePayments bundle is already configured to use fraud_session_id for non-3DS2 transactions.

 To configure your Payment Processing Profile to receive international payments in other currencies, you will have to:

• Enable Payer Authorization in your Payment Processing Profile. This will allow 3DS2 transactions to be used.

• Select the charge and settlement currencies.

• Register with BlueSnap.

Download the MerchantE SuitePayments API Plug-In

Set Up MerchantE Payment Processing Profile

Adding Currencies

Navigate: NetSuite → Lists → Accounting → Currencies → New

1. From the Accounting submenu of the Lists menu, select Currencies. The Currencies screen appears.

2. Click New. The Currency screen appears.

3. Fill out the fields.

   1. Name - Enter the name of the currency.

   2. Default Locale - Set the default location.

   3. ISO Code - Enter the ISO code for the currency. For more information, see ISO Currency Code.

   4. Default Exchange Rate - The default exchange rate for the currency against the base currency of the parent organization. For more information, see Currency Exchange Rates.

   5. Inactive - Check to make the currency inactive. A currency cannot be made inactive if there are pending transactions using the currency.

   6. Override Currency Format - Check to customize the currency display format.

4. Click Save.

Non-NetSuite

Using BlueSnap with the Payment Gateway depends on the type of fraud prevention measure being used.

• Non-3DS2 - Uses a device data check to generate a fraud_session_id.

• 3DS2 - Requires authentication with BlueSnap to generate a threed_secure_referenceId.

Non-3DS2 Transactions

For non-3DS2 transactions, you must include the fraud_session_id in the request parameters sent to the Payment Gateway. The fraud_session_id is sent as part of the transactionFraudInfo directly from BlueSnap. This requires you to implement Kount SDK device data collector. For more information, see Device Data Checks in the BlueSnap documentation.

Additional Information

·       Device Data Check 

·       Implementing Device Data Collector

3DS2 Transactions

Additional Information

·       3D Secure Documents

·       3D Secure Reference

·       Request and Response Examples