Skip to main content

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.

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

1

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. **
    Screenshot 2026 04 27 At 1 39 54 PM
  3. Select Token type : V2/V3 API token
    1. Select the following scopes : 
      ScopeType
      ContentModify
      Checkout ContentModify
      CheckoutsModify
      Metafield OwnershipManage
      Metafield AcessStandard
      CustomersRead Only
      OrdersModify
      ProductsModify
      Order TransactionsRead Only
  4. Click Save & Copy the generated API Credentials.
2

Connect Bigcommerce to Gale

  1. Login to Gale Merchant Dashboard
  2. In Left Sidebar navigate to Integrations Page > Bigcommerce 
    Screenshot 2026 04 27 At 2 02 46 PM
  3. Enter Store Hash and Access Token generated in previous step and hit Connect.
3

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.
Gale Widget
4

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.
Test Checkout

Resources

Test Cards

Use these cards only during testing mode.


Need Help?

If you have questions or need assistance, reach out to us at support@withgale.com. We’re happy to help!