Skip to content

Big Commerce Installation Instructions

Locate your humm Credentials

To integrate humm you will need your

  • Merchant Number
  • API Key

Fill in the online Request API Key Form and we'll send you your unique API Key.

Integrating humm

1. Navigate to: BigCommerce Control Panel.

2. Navigate to: Store Setup › Payments.

3. Under the ‘Online Payment Methods’ section, click on the drop-down arrow.

4. Locate ‘humm’ from the Online Payment Methods list and click the 'Set up' button.

1.png

5. Enter the Merchant ID provided by humm into the Merchant Id field.

6. Enter the Secret Key provided by humm into the Secret Key field.

7. Minimum Amount (Optional).

8. Test Mode — set this to Yes to test checkout flow. Make sure this is set to No when your store goes live.

Please Note - You require humm Sandbox Credentials to use Test Mode. Please reach out to humm integration team via email [email protected] or [email protected]

9. Click Save

Installing Humm Product Page Widgets

Below is an example of humm widget 2.png

1. Go to Storefront> Themes, click the Advanced dropdown and click Edit Theme Files.

2. Locate the product-view.html file.

Note: this filename may differ depending on your theme. We recommend working with a developer to help ensure proper placement.Paste the following script under the price element.

3. Paste one or both of the following scripts under the price element based on what currencies you will be offering Humm in:
You will also need to replace the PLACE_YOUR_MERCHANT_ID field with your unique merchant ID. This will have been provided to you in your welcome email.

New Zealand

 {{#if currency_selector.active_currency_code '===' 'NZD'}}
    {{#if product.price.with_tax}} 
    <script src="https://bpi.humm-nz.com/nz/content/scripts/price-info_sync.js?productPrice={{product.price.with_tax.value}}&merchantId=MERCHANTID"></script>
    {{else}} 
    <script src="https://bpi.humm-nz.com/nz/content/scripts/price-info_sync.js?productPrice={{product.price.without_tax.value}}&merchantId=MERCHANTID"></script>
    {{/if}}
 {{/if}}

Australia

{#if currency_selector.active_currency_code '===' 'AUD'}}
 {{#if product.price.with_tax}}
   <script src="https://bpi.humm-au.com/au/content/scripts/price-info_sync.js?productPrice={{product.price.with_tax.value}}&merchantId=MERCHANTID"></script>
   {{else}} 
    <script src="https://bpi.humm-au.com/au/content/scripts/price-info_sync.js?productPrice={{product.price.without_tax.value}}&merchantId=MERCHANTID"></script>
 {{/if}}
{{/if}} 

4 Click save

Static Banners

3.png

In order to add Humm banners to your site, we recommend using an HTML widget in Big Commerce’s Page Builder feature.

1. Go to Storefront ›My Themes›Customize to launch Page Builder.

2. Navigate to the page you want to add the banner to.

3. Select the HTML widget from the Page Builder menu on the left and drop it into any of the preset regions.

4. Replace the HTML content with one or more of the scripts Humm provides here:

 AU: https://docs.shophumm.com.au/widgets/banners.html 
 NZ: https://docs.shophumm.co.nz/widgets/banners.html

5. Click save and publish