> ## 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.

# Woocommerce

> This guide will walk you through the process of installing and configuring Gale Payments on your WooCommerce store, enabling HSA/FSA payments for your customers.

<img alt="Step 1" classname="block" src="https://mintcdn.com/galepaymentsinc/ES_DCNs-vEFQ6D4Q/images/galecommerce.png?fit=max&auto=format&n=ES_DCNs-vEFQ6D4Q&q=85&s=9e7af9502d1859467c39ce14dd1f02b2" width="1544" height="500" data-path="images/galecommerce.png" />

## Prerequisites

Before you begin, ensure the following:

* **WooCommerce Plugin Installed** : Your WordPress store must have the WooCommerce plugin installed and activated.

***

## Installation Steps

<Steps>
  <Step title="Install Gale HSA & FSA Payments Plugin">
    1. Install [Gale HSA & FSA Payments ](https://wordpress.org/plugins/gale-hsa-fsa-payments/) Wordpress Plugin
    2. Once the installation is complete, **Activate** the Plugin.

           <img src="https://mintcdn.com/galepaymentsinc/-tfqSxxNOR5RQPkA/Screenshot2025-02-10at10.49.38PM.png?fit=max&auto=format&n=-tfqSxxNOR5RQPkA&q=85&s=45a47a5c3cfc1bb7c8c96c4cd9439434" alt="" width="1466" height="196" data-path="Screenshot2025-02-10at10.49.38PM.png" />
  </Step>

  <Step title="Configure Gale Payments Settings">
    1. Navigate to  `WooCommerce > Settings > Payments`
    2. Locate the **Gale Payments** option and click  `Manage`

    <img alt="Step 2" classname="block " src="https://mintcdn.com/galepaymentsinc/ES_DCNs-vEFQ6D4Q/images/manage.png?fit=max&auto=format&n=ES_DCNs-vEFQ6D4Q&q=85&s=e4b003b179e617d7c9c0a0838efa5118" width="2608" height="276" data-path="images/manage.png" />

    1. Enter your **API Key** provided during signup.
    2. Enable  **Test Mode** to verify functionality before going live.
    3. Please select the order status from the dropdown menu after a successful payment — we recommend choosing **Processing**.

    <img alt="Step 3" classname="block" src="https://mintcdn.com/galepaymentsinc/-tfqSxxNOR5RQPkA/Screenshot2025-03-27at4.34.37AM.png?fit=max&auto=format&n=-tfqSxxNOR5RQPkA&q=85&s=884855fc4ff7a746762a06cb0d5a7dff" width="1748" height="1282" data-path="Screenshot2025-03-27at4.34.37AM.png" />
  </Step>

  <Step title="Sync Products with Gale & Verify Eligibility">
    1. Go to **Products** Section in WooCommerce.
    2. **Add** or **Edit** a New Product.

    Once you're in the **Product Editor Page**, go to the **Inventory** section and add the **GTIN/UPC Code** in the field, then **Save**.

    <Warning>
      You only need to enter the GTIN/UPC code **if you are SIGIS approved and using IIAS**.\
      If you are using the **LMN (Letter of Medical Necessity)** flow, you can skip this step.
    </Warning>

    <img src="https://mintcdn.com/galepaymentsinc/-tfqSxxNOR5RQPkA/Screenshot2025-02-13at4.28.39AM.png?fit=max&auto=format&n=-tfqSxxNOR5RQPkA&q=85&s=6643f36125472574d852a19d324008b9" alt="" width="1694" height="482" data-path="Screenshot2025-02-13at4.28.39AM.png" />

    Go to the **Gale Products** page in your WordPress Dashboard Sidebar and click the **Sync Products** button.

    <img src="https://mintcdn.com/galepaymentsinc/-tfqSxxNOR5RQPkA/Screenshot2025-04-14at11.26.07PM.png?fit=max&auto=format&n=-tfqSxxNOR5RQPkA&q=85&s=fc21948c6cd9566c40e333fe99eb090a" alt="" width="1133" height="671" data-path="Screenshot2025-04-14at11.26.07PM.png" />

    **Once all of the products are synced, you can see a list of HSA/FSA Eligible Products on this page.**
  </Step>

  <Step title="Testing the Integration">
    1. Add a product to your WooCommerce store.
    2. Proceed to checkout and select **Pay with HSA/FSA**.
    3. Complete a test transaction using these [Test Cards ](/resources/test-cards)
    4. Verify the transaction appears in your WooCommerce orders.

    <img className="block" src="https://mintcdn.com/galepaymentsinc/ES_DCNs-vEFQ6D4Q/images/step5.png?fit=max&auto=format&n=ES_DCNs-vEFQ6D4Q&q=85&s=a4266901449f04cc798eb6202a73eb6e" alt="Step 4" width="2720" height="1370" data-path="images/step5.png" />
  </Step>

  <Step title="Go Live">
    1. Once testing is successful, go back to the Gale Payments settings.
    2. Uncheck the **Test Mode** option.

    <img className="block " src="https://mintcdn.com/galepaymentsinc/ES_DCNs-vEFQ6D4Q/images/test.png?fit=max&auto=format&n=ES_DCNs-vEFQ6D4Q&q=85&s=9ca82e51d9fd5d02a82100a08b017925" alt="Step 2" width="1488" height="224" data-path="images/test.png" />

    1. **Save your changes.** Your customers can now make payments using their HSA/FSA cards!
  </Step>
</Steps>

## Next Step

<CardGroup cols="1">
  <Card title="Onsite Messaging " icon="octagon-check" href="/onboarding/woocommerce/onsitemessaging">
    Learn how to add **HSA/FSA Eligible** product messaging widgets to WooCommerce using shortcodes.
  </Card>
</CardGroup>

***

## Test Cards

<CardGroup cols="1">
  <Card title="Test Cards " icon="credit-card" href="/resources/test-cards">
    Use these cards only when **Test Mode** is enabled.
  </Card>
</CardGroup>

***

## Troubleshooting

* **Plugin Not Visible** : Ensure WooCommerce is installed and updated to the latest version.
* **API Key Issues** : Double-check your API Key for accuracy.
* **Test Mode Transactions Failing** : Ensure you are using valid test credentials provided by Gale Payments.

***

## Need Help?

If you encounter any issues, contact our support team at [support@withgale.com](mailto:support@withgale.com). We're here to help!

***

By completing these steps, your WooCommerce store is now fully equipped to accept HSA/FSA payments with Gale Payments!