Introduction

MerchantE has created an integration with BlueSnap to maintain a competitive suite of processing capabilities. This integration enables the processing of international transactions while providing onboarding, new product offerings, reporting, and improving the overall customer experience.

To use the MerchantE International Gateway, you will need to sign up for a BlueSnap account and integrate the account with the MerchantE Payment Gateway. This will then allow you to send fields required by BlueSnap for payment processing to the Payment Gateway. Reports for the payments can then be generated in the MerchantE Business Portal. This guide outlines how to set up the MerchantE Payment Gateway to use BlueSnap for international transactions.

Card on File Transactions

Card of File transactions are initiated using a payment method saved by the merchant. These transactions can be initiated either by the cardholder or the merchant. For international payments, the transactions can be linked to previous Card on File transactions using BlueSnap transaction information stored by MerchantE when the transaction was processed.

Cardholder Initiated Transactions (CIT)

When a transaction is initiated by the Cardholder and uses the card credentials that have already been stored by the merchant, it is known as a Cardholder Initiated Transaction (CIT). An example is when a cardholder logs in to a website account and makes a purchase using the card credentials that are stored by the merchant.

Merchant Initiated Transactions (MIT)

When a transaction is initiated by the Merchant per an agreement they have with the Cardholder and uses the card credentials that have already been stored by the merchant. An example is a Fitness Center that automatically processes a monthly transaction for the cardholder’s membership.

Network Transaction ID (NTI) and Original Network Transaction ID

The networkTransactionId (NTI) is the BlueSnap identifier for a transaction. The NTI can be used to retrieve information on previously approved transactions for related transactions, such as subscription services.

An NTI is included in the response for:

• CITs using 3DS2 (threed_secure_refrenceId).

• MOTO transactions which return an NTI.

• MITs which have input parameters referencing previous transactions (transaction_id).

The original NTI (ONTI) is the NTI associated with the original BlueSnap transaction, either processed. The original NTI (ONTI) can then be provided as part of an MIT request to identify the associated transaction.

The ONTI is identified from previous transactions using two methods:

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 Engineering. Sales Engineering will help you complete and test the settings.

   1. help@merchante.com

   2. 1-888-288-2692