Shopify

​

Prerequisites

• Shopify Admin Access: You have administrative access to your Shopify store.
• Gale Payments API Key: You received your API Key during the Gale Payments onboarding process.

​

Installation Steps

1

Install the Gale Payments App

1. Install the Gale HSA & FSA Payments App
2. Follow the prompts to add the payments app to your store.

2

Enter Store Details and API Key

1. After installing the app, you will be redirected to Configure Gale Payments App
2. Enter your Store Name and API Key provided during onboarding.

1. Save your settings.

1. Click Return to Shopify.

3

Configure Gale Payments in Shopify

1. Go to Shopify Admin > Settings > Payments.
2. Click Add Payment Method.
3. Select Search by Provider and type “Gale”.

1. Choose Gale HSA & FSA Payments from the list.

1. Enable Test Mode and click Activate.

4

Setup Gale Pixel

1. Go to Shopify Admin > Settings > Customer Events.
2. Click Add Custom Pixel.
3. Enter Pixel Name “Gale Pixel”.

1. Enter the following Pixel Code and click Connect to save.
   Copy

   analytics.subscribe('payment_info_submitted', (event) => {
     const checkout = event.data.checkout;
     const payload = event.data.checkout;
     fetch('https://checkoutv1.withgale.com/app/order_information', {
       method: 'POST',
       body: JSON.stringify(payload),
       keepalive: true,
     });
   });
   
   

1. Make sure the Pixel status is Connected.

5

Test the Integration

1. Go to your store and add a product to the cart.
2. Proceed to checkout and select Gale HSA & FSA Payments as the payment method.

1. Use one of the Test Cards for the transaction.

1. Verify the order and payment status in your Shopify Admin to ensure that test transaction is successful.

6

Go Live

1. Return to the Gale Payments app in your Shopify Admin.
2. Disable Test Mode in the settings.

1. Save your changes and you are ready to accept HSA & FSA cards using Gale Payments.

​

Resources

​

Troubleshooting

• App Not Visible: Ensure the Gale Payments app is installed and activated in your Shopify Admin.
• API Key Issues: Double-check your API Key for accuracy.
• Test Transactions Failing: Confirm you are using valid Test Cards.

​

Need Help?