Stripe Custom Payment Methods

Add Pay with FSA/HSA to Stripe. Pick the page that matches how you charge.

Gale appears in your Stripe checkout as Pay with FSA/HSA. Gale charges the card on its hosted page. Save a restricted key on Gale on Stripe so Gale can write that payment back to your Stripe account. Fulfill the order from order.completed.

​

Pick your path

How you charge	Follow
One payment, in a Payment Element you already run	Stripe Payment Element
The same customer again, when your own system decides: refills, or renewals you schedule yourself	Stripe Payment Element, then Saved Payment Methods
A subscription that lives in Stripe Billing, where Stripe raises an invoice for each cycle	Stripe Billing Subscriptions

​

What every path shares

1. You create a custom payment method type in Stripe for Pay with FSA/HSA.
2. You save a restricted key on Gale on Stripe.
3. Your server creates a Gale checkout with "metadata": {"payment_source": "stripe_elements_cpm"} and sends the shopper to Gale’s hosted page.
4. Gale charges the card and writes the payment to your Stripe account as a payment record.
5. You fulfill from the order.completed webhook.

The paths differ only in what happens after the first payment.

​

One-time Payment Element

For a single charge in a Payment Element you already run.

Stripe Payment Element

Create the custom payment method, save the restricted key, and send the shopper to Gale’s hosted page when they pick Pay with FSA/HSA.

​

Charging the same card again

Your own system decides when to charge and how much. Gale keeps no schedule.

Saved Payment Methods

Store the card on the first checkout, then charge it by API for each refill or renewal. Each charge is written to your Stripe account.

​

Stripe Billing

Stripe owns the subscription and raises an invoice for each cycle. Gale collects it.

Stripe Billing Subscriptions

The subscription stays in Stripe Billing. Gale collects each invoice and Stripe marks it paid.

​

Subscriptions run by Gale

Gale keeps the plan and the schedule. Check with your Gale contact that this is enabled for your account before you build on it.

Subscriptions

Billing for each cycle, the events that announce a cycle, and how to refund one.

​

Checkout Sessions

For Stripe Checkout, not the Payment Element. Check with your Gale contact that this is enabled for your account before you build on it.

Stripe Checkout

Stripe calls Gale at the endpoint URL on the custom payment method. Leave that URL empty on the Payment Element path.

​

Reference

Gale on Stripe

Where you save the restricted key. Payment Records read and write are required, or the page will not save.

Create Checkout Session

POST /api/v2/checkout. The request every path starts with.

Charge a Payment Method

POST /api/v2/payment-methods/{id}/charges. Used for refills and renewals.

Payment Method Object

The stored card you receive after a checkout that saves it.

Order Object

What order.completed carries, and your permanent record of a payment.

Webhooks

How to verify X-Gale-Signature, and which events to subscribe to.

Refunds

Refund with POST /api/v2/refunds. Stripe does not refund these charges.