Posted on September 14, 2019 at 6:00 PM
Accept Altcoins on Bigcommerce

How to accept Cryptocurrency on Bigcommerce Stores.

In this article we are going to show you how to integrate the CryptocurrencyCheckout Platform into your Bigcommerce store so that you can start accepting Cryptocurrencies like: Bitcoin, Ethereum, Litecoin, Dash, and More as payment for your sales.

There are several ways to go about integrating CryptocurrencyCheckout into Bigcommerce's platform. However there are a few requirements that we would like to meet on our integration in this article, as well as a few hurdles we must overcome.

Things we want to achieve in this integration:
  1. We would like to maintain all of our orders inside of Bigcommerce’s platform. This includes using Bigcommerce’s checkout process to securely generate an order, collect buyer info, calculate shipping costs, taxes, offer discounts, allow coupon codes, etc.
  2. We would also like to leave the ability for customers to be able to review their past orders, and maintain all order records on our Bigcommerce store itself.
  3. We want the order to stay in “Pending Payment” status until we can manually verify we have received the crypto payment, allowing us to make sure that all confirmations are received on the blockchain before changing the order status to “payment received”.
  4. We want to be able to use our standard Shipping and Bookkeeping integrations for Bigcommerce, without needing any additional plugins or software to add CryptocurrencyCheckout to our store.

Hurdles we must overcome to achieve this:
  1. One of the biggest disadvantages to Bigcommerce is that they currently do not offer any Cryptocurrency Payment Options for Sellers. On most other platforms this can be resolved with custom code to allow you to integrate your own Payment Gateway into the Checkout.
  2. Unfortunately Bigcommerce's new Stencil Theme does not currently allow sellers to directly customize or add code/scripts to the checkout process itself. They have mentioned possibly opening this up to customization if the future, but currently it is on lockdown.
    So we're going to have to get creative to get around this.
  3. We want to be able to securely pass order information such as order ID, and Order Total (Price) to the CryptocurrencyCheckout Platform while making sure there is no possibility of wrong orders details being sent.

Our Two Solutions to achieve integration while meeting all of the requirements above:

Option #1: Add a "Pay With Cryptocurrency" Button to the Order Receipt Email, the buyer will be able to complete payment once the email is received.

Option #2: Or Add a "Pay With Cryptocurrency" Button to the Customer Dashboard, so that they can pay from their order history page.

In this guide we will be showing you how to do both options. You can choose to use one or both options if you prefer.

Bigcommerce Cryptocurrency Checkout Installation.

Step 1: Create a CryptocurrencyCheckout payment option in Bigcommerce.

Log into your Bigcommerce Admin Dashboard.

Click on "Store Setup" located on the left side.

Select “Payments” from the available options.

Locate the “Offline Payment Methods” option located near the top.

Slide the “Bank Deposit” method to enabled.

In the top tabs select the "Bank Deposit Settings" tab.

Fill out the details as desired for your store

Our Example:
Display Name


Available Countries

All Countries

Payment instructions:

Thank you for your purchase!
Making your Cryptocurrency Payment with Bitcoin, Litecoin, Ethereum or Dash:

You will receive an Email to complete your Cryptocurrency Payment shortly.
Once you Receive your Order Confirmation Email, press the "Pay Now With Cryptocurrency" Button inside the email.

Or Alternatively, Login and navigate to your order history page:
Once there click on the order you want to pay for, then press the "Pay Now With Cryptocurrency" Button.

You will be securely passed to CryptocurrencyCheckout to finalize your payment.

Please contact us if you have any questions or issues.

Click Activate.

Step 2: Create Cryptocurrency Checkout Connection.

Log into your Dashboard.

Click on the “New Connection” option.

Insert your store details. Such as Store Name and Store Currency.

Now insert the Wallet Addresses of all the Cryptocurrencies you would like to receive.

If there is any Cryptocurrencies you do not want to accept on your store just leave those sections blank.

Optional: Select if you would like to charge a markup to accept an individual crypto, or offer a store discount.

Optional: You can also view how to use our Market Volatility Protection Tools Here

Click Submit.

Step 3: Generate CryptocurrencyCheckout Script.

Log into your Dashboard.

Click “API Keys” Generate an API key for your store.

Copy and paste the API Key into a notepad, or another text editor for later.

In the dashboard, go to the Installation Scripts > Store Integrations and select “Bigcommerce Stencil”.

Paste the API key you saved earlier into the “Insert API Key” Section.

Click the “Generate Installation Scripts” button.

Two installation scripts will be automatically generated for your store.
(One for the Email Option, and one for the Order History Page Option)

Copy and paste which one you want to use (or both) into notepad or another text editor.

On the "Order History Page" Option Script:
Remove the periods located in the store variables surrounded by double curly braces. (( (( ((
View the Image below for example.

(Our site uses similar code to Bigcommerce so we must add the periods to make them show in the generated script.)

Step 4: Installing the Email Option into your Bigcommerce Store (Easy Installation.)

Log into your Bigcommerce Admin Dashboard.

Click on the Storefront tab on the left.

Choose the "Email Templates" option from the left tab.

Expand the "Snippets" Folder

Locate and Edit: InvoicePendingPaymentNotice.html

Click "HTML" on the editor bar to open the HTML Source Editor

Below the code that is there, Paste in the shorter "Email Template Option" Script you generated in the CryptocurrencyCheckout Dashboard.
(If you like you can customize the inline styles of the button and the text.)

Press the Update button on the HTML Source Editor. (You should see the Payment Button appear.)

This will add the CryptoCheckout payment button to your Order Confirmation Emails.

Press Save.

Step 5: Installing the Order History Page Option into your Bigcommerce Store

Log into your Bigcommerce Admin Dashboard.

Click on the Storefront tab on the left.

Choose the "My Themes" option from the left tab.

Click on "Advanced" for your current theme.

Select "Edit Theme Files" from the dropdown.

Locate and open: templates/pages/account/orders/details.html

Scroll to the middle of the code.

Locate in the code: ((#if order.order_instructions))

Paste the CryptocurrencyCheckout Script you generated between the ((#if order.order_instructions)) field, and the dt class="order-payments-description" div.

This will add the CryptoCheckout payment button to your store.

Press Save.

You have successfully integrated Cryptocurrency Checkout into Bigcommerce!

You should generate a test order on your store. and go through the entire checkout process to make sure everything works as desired.

Verify that both the Button in the Order Confirmation Emails is working, as well as the button on the Customer Dashboard Order Page.

If you have any issues feel free to send us a message, or join us on discord.