Ecommerce
BigCommerce

Installing BlueCheck on BigCommerce

6min

Installing The Verification Script

The verification script triggers the verification process during the checkout process and is used to launch the verification modal if it is required. Depending on what type of checkout you are using the installation instructions will be slightly different.

The script you will be adding is below. It is the same script regardless of checkout type.

JS


Optimized One-page Checkout

  1. Duplicate You Current Theme
    1. From you stores dashboard navigate to Storefront -> My Themes
    2. Under your current theme, select Advanced and then Make A Copy.
    3. Click Save A Copy in the resulting window. You have no created a copy of your current theme.
  2. Add The BlueCheck Script To The New Theme:
    1. Select the new theme you made above and then click Customize and then Edit Theme Files on the left hand sidebar.
    2. From the File Editor page look for the Checkout folder or the Checkout.html file, typically located under templates -> core OR templates -> pages. Click into the Checkout.html file.
    3. Scroll down to the bottom of the code and find {{{ checkout.checkout_content }}}. Insert the script below that text. Make sure to replace "YOUR_DOMAIN_TOKEN_HERE" with your domain token which can be found on the Installation page of the Merchant Portal. Save the edited file.
    4. Navigate to Storefront -> My Themes from the dashboard. Apply the new theme you created earlier with the BlueCheck script added and BlueCheck verification script will be installed. If you wish to unistall, just switch back the original theme.

Now that that the script has been installed, you can also install the optional secondary check.

Custom One-page Checkout

Note: Note: If there is not an option for Checkout Template Files, you will need to manually access the page by changing your URL. Replace everything after the store URL with "/manage/storefront-manager/template-files". For example, https://example.com/manage/storefront-manager/template-files

  1. Finding the ExpressCheckoutConfirmation.html file.
    1. From your dashboard navigate to Storefront -> Checkout Template Files and then click the three dots on the right to edit.
    2. Find the ExpressCheckoutConfirmation.html file. If you do not see it you can search using ctr/cmd + F. The file should show under Other Template Files in the left sidebar.
  2. Adding the script.
    1. Click ExpressCheckoutConfirmation.html to open it. At the bottom of the file you should see a </form> tag. Insert the script at the top of the page into the file below this tag.
    2. Replace "YOUR_DOMAIN_TOKEN_HERE" with your domain token which can be found on the Installation page of the Merchant Portal. Save the edited file.

Now that that the script has been installed, you can also install the optional secondary check.

Express Checkout on Mobile

  1. Set up Mobile Template Files
    1. Ensure that you have mobile themes enabled. This can be done from Storefront -> Mobile Theme Settings.
    2. Download the Mobile Template Files and unzip the folder. Within the Snippets folder you should find the ExpressCheckoutConfirmation.html file.
  2. Adding the Script and Uploading the New File.
    1. Open the ExpressCheckoutConfirmation.html file in a text editor and and find the </form> tag at the bottom of the file.
    2. Insert the script below that text. Make sure to replace "YOUR_DOMAIN_TOKEN_HERE" with your domain token which can be found on the Installation page of the Merchant Portal. Save the edited file.
    3. From your BigCommerce dashboard navigate to Server Settings > File Access (WebDAV). Access your BigCommerce store using the WebDAV credentials provided.
    4. Once logged in locate mobile_template -> Snippets. Upload the ExpressCheckoutConfirmation.html file that you edited in Step 2 to the Snippets folder in WebDAV. After the upload is complete BlueCheck will be installed for mobile.

Now that that the script has been installed, you can also install the optional secondary check.

Installing The Secondary Check

The instructions for installing the secondary check are the same no matter which type of checkout you are using.

  1. Create an API Account
    1. From your BigCommerce site click Advanced Settings -> API Accounts. Create a new API account for using BlueCheck. Do not edit API Path that is automatically generated by BigCommerce. The OAuth scopes should be set as follows:
      1. Content: modify
      2. Information & Settings: read-only
      3. Orders: modify
      4. 
    2. Click the Save button. A file will be automatically created by BigCommerce that contains the Access Token, Client ID, Client Secret, Name, and API Path. Save the created file.
  2. Store the information on the Merchant Panel
    1. Log into the BlueCheck Merchant Portal and go to the Installation page.
    2. Choose BigCommerce from the Platform selection dropdown. You may have to unselect BigCommerce and select it again in order to generate the input fields necessary for the next step.
    3. Enter the info from the file you saved after creating the API Account into the corresponding input boxes. Click the Save button.

The secondary check is now installed.

Updated 21 Sep 2023
Doc contributor
Did this page help you?
PREVIOUS
Pre-Approve Users for Verification (Merchant Pass)
NEXT
Installing BlueCheck on Lightspeed Ecommerce
Docs powered by Archbee