eCommerce Plugin Guide

BitFlow provides variouseCommerce plugins which you can download and use to accept cryptocurrency payments from customers at checkout on your eCommerce store.

Part 1: Adding your website domain to the Merchant Gateway platform.

Step 1. Log in to your BitFlow Merchant Gateway account. On the navigation menu, click "ECOMMERCE PLUGINS"

Step 2. Enter your eCommerce website domain and click "Add". This will generate a Web Plugin Id which will be used later on in the setup process.

Step 3. Download the applicable plugin based on the platform you used to build your eCommerce website.

Step 4. You will need your API Keys and Secret to authenticate payment requests with the web server. To find your API Keys and Secret, click on "Account" > "API Keys". Make sure to use the Live API Keys and Secret for real transactions, and only the sandbox keys in a testing environment.

Tip: Keep your Merchant Gateway Account open in a browser window to easily copy and paste your Web Plugin Id, and API Keys and Secret in the following steps. 

Part 2: Connecting the Ecommerce Plugin to your website.

In Part 2 of the instructions, although the general concepts of adding and connecting the plugin to your website is the same, the exact set up instructions will vary between the different platforms (e.g. WordPress - Woo Commerce, Magento etc.).

Find the platform you used to build your website below and follow the set up instructions. 

WordPress Plugin Setup 

Important Note: In order to use the WordPress plugin, you must have WooCommerce plugin already installed. WooCommerce can be downloaded from the WordPress plugins store. 

Step 1. Log in to your WordPress administrative account.

Step 2. On the left navigation bar, click "Plugins" → "Add New". You can choose either one of the following methods to add the BitFlow Plugin, but we recommend Method 1 for a simpler and faster approach:

Method 1. WordPress Store : Search for BitFlow in the plugin store and click "Install Now" → "Activate".

Method 2. Manual Plugin Installation: Click "Upload Plugin". Download bitflow-gateway.zip file provided on the Merchant Gateway platform. Click "Install Now → Activate Plugin".

Step 3. On the left navigation bar, click "WooCommerce" → "Settings" → "Payments" → "Cryptocurrency via BitFlow".

If you are not using the latest version of WooCommerce, click "Checkout" instead of "Payments".

Step 4. Check "Enable BitFlow Widget Gateway". Fill out the Cryptocurrency via BitFlow form and save.

Your API Keys and Web Plugin ID are information available on your Merchant Gateway account, and here is where you can find them:

• API Keys and Secret: Click "Profile Icon (top right hand corner)" → "Settings". Use live API Keys and Secret for real transactions. Only use sandbox API Keys and Secret in a testing environment.
• Web Plugin Id: Click "Ecommerce Integration (navigation bar)". The unique Web Plugin Id is shown under your list of added domains.

For the Plugin endpoint, use https://merchant.bitflow.com. If you are a white-label merchant, use your custom URL.

You can customize the description that the user sees during checkout and instructions that will be displayed on the thank you page.

Congratulations! You are now ready to accept cryptocurrency payments from customers on your Ecommerce website.

Magento Plugin Setup

Step 1. Go into Magento Admin → Stores → Configuration → Sales → Payment Methods

Step 2. Select Cryptocurrency via BitFlow payment method and click API Settings.

Step 3. Fill in your API key and secret, and web plugin id.

Step 4. While still in the Cryptocurrency via BitFlow section, change enabled to yes to allow BitFlow at checkout. You will be notified via the Magento plugin of the different payment statuses:

Complete: Amount due equals amount received in cryptocurrency

Payment Review: Amount received is less than or greater than the amount due