> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withgale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BigCommerce

This guide will walk you through installing and configuring Gale HSA/FSA Payments on your BigCommerce store.

***

## Prerequisites

Before starting, make sure you have access to:

* **BigCommerce Store**
* **Gale Merchant Dashboard**

***

## Installation Steps

<Steps>
  <Step title="Generate Bigcommerce API Credentials ">
    1. In your bigcommerce admin panel Navigate to **Settings**
    2. Scroll down to **API Section** > **Store-level API Accounts** > \*\*Create API Account. \*\*
           <Frame>
             <img src="https://mintcdn.com/galepaymentsinc/h_lSOxgUh8hdqeQX/images/Screenshot-2026-04-27-at-1.39.54-PM.png?fit=max&auto=format&n=h_lSOxgUh8hdqeQX&q=85&s=75732cc748b7af627a34a670eec72769" alt="Screenshot 2026 04 27 At 1 39 54 PM" width="1114" height="728" data-path="images/Screenshot-2026-04-27-at-1.39.54-PM.png" />
           </Frame>
    3. Select Token type : **V2/V3 API token**
       1. Select the following scopes : 
          | Scope               | Type      |
          | ------------------- | --------- |
          | Content             | Modify    |
          | Checkout Content    | Modify    |
          | Checkouts           | Modify    |
          | Metafield Ownership | Manage    |
          | Metafield Acess     | Standard  |
          | Customers           | Read Only |
          | Orders              | Modify    |
          | Products            | Modify    |
          | Order Transactions  | Read Only |
    4. Click Save & Copy the generated API Credentials.
  </Step>

  <Step title="Connect Bigcommerce to Gale ">
    1. Login to **Gale Merchant Dashboard**
    2. In Left Sidebar navigate to **Integrations** Page > **Bigcommerce** 
           <Frame>
             <img src="https://mintcdn.com/galepaymentsinc/h_lSOxgUh8hdqeQX/images/Screenshot-2026-04-27-at-2.02.46-PM.png?fit=max&auto=format&n=h_lSOxgUh8hdqeQX&q=85&s=1552cf4b01c0f1302b1fdb13e6ca0990" alt="Screenshot 2026 04 27 At 2 02 46 PM" width="2088" height="1232" data-path="images/Screenshot-2026-04-27-at-2.02.46-PM.png" />
           </Frame>
    3. Enter **Store Hash and Access Token** generated in previous step and hit **Connect**.
  </Step>

  <Step title="Use Page Builder Widget">
    1. Go to **Storefront → Page Builder**.
    2. Look for the **HSA & FSA Accepted** widget.
    3. Drag and drop it onto any product page.
    4. Click **Publish** to make it live.

    <img className="block" src="https://mintcdn.com/galepaymentsinc/-tfqSxxNOR5RQPkA/Screenshot2025-06-02at9.23.52PM.png?fit=max&auto=format&n=-tfqSxxNOR5RQPkA&q=85&s=19814707be79d2d888eadb888544321d" alt="Gale Widget" title={true} width="2782" height="1218" data-path="Screenshot2025-06-02at9.23.52PM.png" />
  </Step>

  <Step title="Test the Checkout Flow">
    1. Go to your storefront and add a synced product to the cart.
    2. Proceed to checkout and select **Gale HSA & FSA Payment**.
    3. You will be redirected to a secure hosted Gale checkout page.
    4. Use the test cards to complete payment (Only works if Test Mode is Enabled).
    5. After payment, you’ll be redirected back to your store’s order confirmation page.

    <img className="block" src="https://mintcdn.com/galepaymentsinc/-tfqSxxNOR5RQPkA/Screenshot2025-06-02at9.22.25PM.png?fit=max&auto=format&n=-tfqSxxNOR5RQPkA&q=85&s=6ce52cff0d774d96ba6d66cc64d2beef" alt="Test Checkout" title={true} width="2378" height="1362" data-path="Screenshot2025-06-02at9.22.25PM.png" />
  </Step>
</Steps>

***

## Resources

<CardGroup cols="2">
  <Card title="Test Cards" icon="credit-card" href="/resources/test-cards">
    Use these cards only during testing mode.
  </Card>
</CardGroup>

***

***

## Need Help?

If you have questions or need assistance, reach out to us at [support@withgale.com](mailto:support@withgale.com). We're happy to help!
