Setup Guide for PrestaShop and BlueSnap This manual is meant to show you how to connect your PrestaShop store with your newly created BlueSnap account. It will show step-by-step instructions. For any further help, please contact BlueSnap merchant support at merchants@bluesnap.com. Setting up BlueSnap BlueSnap offers two environments: Sandbox OPTIONAL. For testing only. Transactions processed in the Sandbox environment will never charge a credit card. Production REQUIRED. You must set this up to process live transactions on through your store. Optional for test environment only Create your Sandbox environment here: https://sandbox.bluesnap.com/jsp/developer_login.jsp. Once you have opened a sandbox account, write an email to merchants@bluesnap.com requesting to run an on-boarding script for your sandbox account. Include your Sandbox BlueSnap Merchant account ID and your PrestaShop store domain (for instance http://www.yourbestbuys.net). This procedure will open a ticket for you in our merchant support system, and within 3 days you should receive an update confirming that your sandbox account is ready. Proceed to step 2 only after you have received confirmation that your Sandbox account is ready. 1. Your BlueSnap account will be the first step in the process. BlueSnap's sales representative has provided you with a Production merchant ID, containing seven digits starting with the numbers "108 ". You also have received credentials to login to your Production account. If you have not yet received a set of credentials or your Production merchant ID, please contact your BlueSnap sales representative. Login link: https://www.bluesnap.com/jsp/developer_login.jsp. 1
2. Click the 'BlueSnap API (Shopping Carts)' option, at the bottom left of the console. In this BlueSnap API page, select an API password. Click on the Change Password widget next the Password field. (Note: your temporary password is Welcome1 ) Password rules: Minimum of 7 characters Must contain one capital letter and one digit Must start with a letter Should not contain consecutive characters. Important: Please record your API Password for later. 3. Your API Username will be displayed on the screen, starting with "API_" and a long string of characters. Save it for later, together with these additional details which are presented to you at this page, as you will need to enter them during your PrestaShop account configuration: your Store ID your Data Protection Key your Contract ID Important: Please write down your API Username, Store ID, DataProtection Key, and Contract ID used later when setting up your PrestaShop store 4. From the menu on the left-hand side of the Dashboard, select the 'BuyNow Settings' option. In this section, you need to choose the methods of payment you would like to offer to your shoppers on your shopping cart checkout. You can come back to this step at any time. 2
5. Before you start selling, make sure to set up your payout preferences; under the menu on the top right corner, click on Account Settings -> Payout Method then pick your Payout Method and fill in the required information. Your BlueSnap account is now ready! You can continue to the next step and configure the BlueSnap payment module in your store. 3
Setting up PrestaShop The PrestaShop setup is quite simple all you need to do is get the latest BlueSnap module from the PrestaShop Addon Marketplace and then install the module. 1. In the PrestaShop admin, select 'Modules' -> 'Modules and Themes Catalogue' under the left hand side menu. In the search bar located in the top right, search for 'BlueSnap'. You should see 'BlueSnap all-in-one global payment' as a suggested module. Click on it, and a new tab should open: 2. In the newly opened tab, click on the BlueSnap module: 4
3. In the BlueSnap module screen, click on 'Download'. You may need to login to the website first: 4. A download pop up window may appear in your browser. Save the module locally on your machine, in a place you can access later: 5
You can close the newly opened tab and move back to the PrestaShop admin. From the left menu select 'Modules'->'Modules': 5. In the PrestaShop Module section, select to add a new Module by clicking the button in the top right corner. Then select the file you downloaded in a previous step and upload it: 6. After the module is uploaded and available, in the same screen, scroll down until you see the list of installed modules. In the section 'Payments and Gateways' you will see the 'BlueSnap BuyNow' module. Click on the 'Configure' button next to it to configure the BlueSnap module parameters: 6
7. In the BlueSnap module configuration screen, you have several parameters you need to fill in: a. Sandbox Mode yes or no. If yes, the 'Sandbox username' and 'Sandbox password' will be used. If No, the 'Username' and 'Password' will be used. b. Sandbox username the API Username defined in your BlueSnap sandbox account c. Sandbox password the API Password defined in your BlueSnap sandbox account d. Is Debug Mode Enabled - Leave in 'no' unless there is an issue you wish to follow in the logs. This is also valid for the second selector. e. Username - the API Username defined in your BlueSnap production account f. Password the API Password defined in your BlueSnap production account g. Store ID the BlueSnap Store ID you wish to work with (can refer to either sandbox or production, according to the 'Sandbox Mode' selector) h. Data Protection Key The Data Protection Key you defined in your BlueSnap account (can refer to either sandbox or production, according to the 'Sandbox Mode' selector) i. Contract ID the Contract ID you defined in your BlueSnap account (can refer to either sandbox or production, according to the 'Sandbox Mode' selector) Your PrestaShop BlueSnap integration is now ready to use! 7