Skip to main content
Sign in MENU

Gateway - New Merchant Setup

MINIBC Support
  • Updated

The below is a general guide for each gateway available within MINIBC. The instructions below assume you’re logged into both your gateway with the proper permission and your BigCommerce account with access to the MINIBC application.

Setup - Authorize.net 
Setup - Braintree by PayPal
Setup - Stripe
Setup - NMI
Setup - USAePay
Setup - CyberSource 
Setup - Wallet - Apple Pay
Setup - Wallet - Google Pay


If you don’t see the gateway you require assistance with please contact our support team or your Project Manager.
 

Setup - Authorize.net 

For MINIBC to work with Authorize.net, we require that the Customer information Manager (CIM) feature be enabled within your account. To setup the gateway within MINIBC the following fields are required:

API Login ID
Transaction Key
Public Client Key
Signature Key

Locating Items:

  • API Login ID: This can be found within the Account tab and within the Security Settings sub-section by clicking on API Credentials & Keys. 
     
  • Transaction Key: This can be also found within the Account tab and within the Security Settings sub-section by clicking on API Credentials & Keys. Note that if you have an existing key for an in-use store, it is recommended to continue using key as you risk deactivating the existing key and causing issues with that store.
     
  • Public Client Key:  This can be found within the Account tab and within the Security Settings sub-section by clicking on Manage Public Client Key. 
     
  • Signature Key: This can be also found within the Account tab and within the Security Settings sub-section by clicking on API Credentials & Keys. Note that if you have an existing key for an in-use store, it is recommended to continue using that key as you risk deactivating the existing key and causing issues with that store.
     
  • MD5 Hash: As of January 2025 this item is no longer required and can be skipped if it is still present within your dashboard setup. 

After all items have been located and added to MINIBC (and BigCommerce where needed) you can reach out to our support team or your Project Manager to move forward.

 

Setup - Braintree by PayPal

For MINIBC to work with Braintree, we require that you have a Braintree Direct account. This account type enables API access which is required by MINIBC. To setup the gateway within MINIBC the following fields are required:

Merchant ID
Merchant Account ID
Public Key
Private Key

Locating Items:

  • Merchant ID: This can be found by clicking the “gear” in the upper right and navigating to Business. The merchant id can be found near the top of the page.
     
  • Merchant Account ID: This can be found by clicking the “gear” in the upper right and navigating to Business. The merchant account id can be found in the middle of the page; it will be beside the area with the credit card logos and currency display.
     
  • Public Key: This can be found by clicking the “gear” in the upper right and navigating to API. Once on the API page the public key should be visible.
     
  • Private Key: This can be found by clicking the “gear” in the upper right and navigating to API. Once on the API page the private key requires you to click “view” and then copy the key. The Private Key is longer than the Public Key.

After all items have been located and added to MINIBC (and BigCommerce where needed) you can reach out to our support team or your Project Manager to move forward.

 

Setup - Stripe

To setup the gateway within MINIBC the following fields are required:

Publishable Key
Account ID
Secret Key
Signing Secret

 

Locating Items:

  • Publishable Key: Click the on Gear icon and choose Settings. Choose Developers, enable the slider beside Enable Workbench. Choose your preference on appearance and choose PHP as the SDK language.  Within the workbench, beside the API Keys title, click on Manage API keys. This key starts with “pk_live” or “pk_test” depending on which environment you’re setting up. The publishable key should be variable and can be copied into MINIBC. 
     
  • Secret Key: Following the above details to reach the same location. The secret key will be hidden and need to be revealed. This key starts with “sk_live” or “sk_test” depending on which environment you’re setting up. Copy the revealed key into MINIBC.
     
  • Account ID: Click on the "Gear" icon and choose Profile from the drop-down. At the bottom of the Profile page is section titled Accounts. Below this title is a table, within that table, you want to find the "ID" column and the value that begins with acct_, copy this value into MINIBC. 
     
  • Signing Secret: See below. 

Setting Up Webhook Notifications and Signing Secret:

Stripe allows MINIBC to receive webhook notifications of specific events that can impact orders and tokenized cards. Follow the below guide to set up these notifications.

  1. In MINIBC location your Webhook Notification URL and have that handy.
  2. In Stripe, search for "create a webhook" and click on the nav item that appears under the Workbench sub-heading. 
  3. Choose "Your account" for the Events from item. 

  4. Under the Events choose/enable the following:

    charge.captured
    charge.expired
    charge.failed
    charge.pending
    charge.refund.updated
    charge.refunded
    charge.succeeded
    charge.updated
    payment_intent.succeeded
    payment_method.card_automatically_updated
    payment_method.detached
    payment_method.updated

    Once chosen, you can click “Continue”.

  5. For Destination type choose the "webhook endpoint" item. Then click "Continue"

  6. Within the Configure destination screen enter the following:

    Destination Name: MiniBC

    Endpoint URL: Enter the URL you copied from within the MiniBC Dashboard

    Description: Leave empty 

    Once completed, you can click “Create destination”.

  7. On the far right, under Signing Secret click the eye icon and copy the "whesc_" item into the MiniBC dashboard into the Signing Secret input. 
  8. Save the changes in MiniBC and you're good to go.
     

After all items have been located and added to MINIBC (and BigCommerce where needed) you can reach out to our support team or your Project Manager to move forward.

 

Setup - NMI

To setup the gateway within MINIBC the following fields are required:

Username
Password
Processor ID
API Key


Locating Items:

  • Username & Password: This is the username and password you use to login to your account. You have the option of creating MINIBC its own user or providing your current login credentials. Note that if/when you update your password, this password needs to be updated within MINIBC as well.

     

  • Processor ID: If you’re running a single processor you’ll need to check with your NMI agent or customer support to gather this value. If you’re running multiple processors you can find (or choose) a processor by navigating to Options -> Settings -> Transaction Routing and gathering your preferred Processor ID. 

     

  • API Key: This can be found/created by navigating using the side menu; Options -> Settings -> Security Keys. If not already created, choose the “Add a New Private Key” and complete the form. You can name the API key (MINIBC or similar) for easy identification and also assign it to the main account holder or the “MINIBC” user if you choose to create one. For Key Permission choose “API” during the process. Once created, copy the API key into MINIBC. 

After all items have been located and added to MINIBC (and BigCommerce where needed) you can reach out to our support team or your Project Manager to move forward.

 

Setup - USAePay

To setup the gateway within MINIBC the following fields are required:


Source Key

PIN

 

Locating Items:

  • Source Key: This item can be found/created under, Settings -> API Keys. Within this panel you can either create a new API key set (and name it as needed); or access an existing API key and copy the key already created. Copy the API Key from the panel and add this to MINIBC.

     

  • PIN: This item can be found within the API details panel. It should be the item above the API Key you copied in the above step. Copy this PIN  from the panel and add this to MINIBC.

     

After all items have been located and added to MINIBC (and BigCommerce where needed) you can reach out to our support team or your Project Manager to move forward.

 

Setup - CyberSource

Before proceeding with the below, you'll need to verify your account with CyberSource has the TMS service enabled. Once verified, you can move forward to setup this gateway within MINIBC the following fields are required:


Merchant ID
Secret Key
Transaction Key

 

To create these items you will need to login to your CyberSource admin panel and follow the below step.

  1. Once logged in, within the Payment Configuration item, click on Key Management


    Choose "Generate Key" in the upper right-hand corner.
     

  2. Within the Create Key panel, under REST APIs choose "Rest - Shared Secret" from the available methods, then click "Generate Key". 

    cs-rest-1.png
     

  3. Upon successful key generation, a confirmation screen will be presented. Copy the text under "Key" and enter it under Transaction Key input within the MINIBC dashboard. Then copy the text under "Shared Secret" and enter it under Secret Key also within the MINIBC dashboard. 

    cs-rest-2.png
     

  4. Use the search function to locate your key; note that you will (likely) need to change the "Expire At" filter to "All Dates" to see your newly created key in the results. Copy the Merchant ID from your newest created key into MINIBC. 

    cs-rest-3.png
     

  5. With both fields within MINIBC filled in you can click Save within MINIBC. Note be sure to enable "Use Production Mode" if inputting production level credentials. 

    cs-rest-3a.png

Note: For those transitioning from the older SOAP API, the Merchant ID will remain the same but it is important to note that the Transaction Key will need to be updated.

 

Wallet Setup - Apple Pay

For support gateways (contact support for a current list), the following general process should be completed:

  1. Create a MiniBC support ticket using the link in your dashboard. The following can be used:

    Subject: Apple Pay Deployment Request

    Message:

    Hi MiniBC Support,

    We would like to have Apple Pay deployed on our store for payment and/or subscription processing. Please complete the necessary script updates so that we can proceed with the next steps in your process. 

    Thanks,

    {Insert Name}

  2. MiniBC support provide updated scripts to hide Apple Pay while the process continues.
  3. Once MiniBC has confirmed the scripts addition, active Apple Pay in BigCommerce, see here
  4. Download the Apple Domain File
    1. For Stripe - directions on registering your domain and downloading the file can be found here. 
    2. For Braintree - can be found here, see the link provided in step 9

  5. Create a support case with BigCommerce via BigCommerce Support using the following message.

    Subject: Custom Apple Pay Domain File hosting

    Message:

    Hi BigCommerce Support,

    I need your help to add our custom domain Apple Pay verification file as attached to my store The BigCommerce engineering ticket reference for this feature is PAYMENTS - 9997

    {Insert Store URL here}.

    {Insert Attachment}

    Thanks,

    {Insert Name}

  6. Once BigCommerce has confirmed the custom domain file has been applied; contact MiniBC support to remove the Apple Pay restrictions.
  7. Once MiniBC confirms the scripts have been updated; checkout using Apple Pay on your Apple device. 

Wallet Setup - Google Pay

For supported gateways (contact support for a current list), MiniBC requires a Google Pay Merchant ID. 

  1. To obtain your Google Merchant ID, you'll need to complete the following steps found here. 
  2. Once you have your Google Merchant ID, you can enable Google Pay within MiniBC with the Payments section and there within your chosen gateway. Click the "Enable Google Pay" slider to reveal the Merchant ID entry area. Enter your merchant id and save your changes. 

  3. Create a MiniBC support ticket using the link in your dashboard. The following can be used:

    Subject: Google Pay Deployment Validation

    Message:

    Hi MiniBC Support,

    We have completed the required entry our Google Pay Merchant ID into our payment gateway within MiniBC. Please validate and update our deployment as required. 

    Thanks,

    {Insert Name}

  4. MiniBC will then validate and confirm your Google Pay setup. 

 

Related articles