Using Limio Price with Stripe

How to configure subscription pricing on Limio Offers for Stripe Billing

This article covers pricing for subscription products using Stripe Billing.

• For setting up the Stripe Product Code, see Stripe Product Code

• For one-time products, see How to Configure a One-Time Offer

How Limio Price works with Stripe

When a customer purchases an Offer, Limio dynamically creates a Stripe Price based on the Offer's pricing configuration and attaches it to the linked Stripe Product. There is no need to pre-create prices in Stripe — Limio handles this at order time.

Limio automatically converts prices to Stripe's smallest currency unit (e.g. £50.00 becomes 5000 pence for GBP).

Configure a Limio Offer for Stripe

To make pricing work with Stripe, you need to configure the following on a Limio Offer:

• Stripe Product Code — links the Offer to a Stripe Product

• Limio Price — defines the charges

• Auto Renew — whether the subscription automatically renews

Limio Price

Within the Limio Price field on the Offer, you define the charges that apply to the subscription. Each charge maps to a Stripe Price and Subscription Item.

Charge fields

Field	Description	Example
Value	The charge amount in the currency's standard unit	50.00
Currency Code	ISO currency code	GBP
Type	recurring for ongoing charges, one_time for a single charge	recurring
Trigger	When the charge starts: subscription_start or delayed	subscription_start
Repeat Interval	Number of intervals between charges	1
Repeat Interval Type	Billing frequency: days, weeks, months, or years	years
Repeat Count	Number of billing cycles (for fixed-term charges)	1

Charge types

Type	Description	Example
One continuous recurring charge	A single recurring amount charged at a regular interval	£50 per year
One one-time charge	A single upfront charge with no recurrence	£25 joining fee
Two overlapping charges	A one-time charge combined with a recurring charge	£25 joining fee + £9/month

Stripe Product Code

Each Offer must reference a Stripe Product. On the Offer, set the Stripe Product Code attribute to the Stripe Product ID (e.g. prod_TpFpO4EkIM28wn).

See Stripe Product Code for setup instructions.

Auto Renew

If Auto Renew is turned on, the Stripe Subscription will automatically renew at the end of each billing period. If off, the subscription will not renew at the end of the current billing period.

Billing Anchor Date

You can set a Billing Anchor Date on the Offer to align all subscription renewals to a specific date regardless of when the customer purchased.

For example, setting the anchor to June 1 means a customer purchasing on 19 December would be charged the full price immediately, with their subscription renewing on 1 June.

Billing anchor dates can be customised further using the beforeStripeSubscription plugin hook — see How Limio Events Update Stripe.

Worked example

Here is a complete example of a Limio Offer configured to create a Stripe subscription:

Offer: Adult Membership — £50/year

Offer field	Value
Stripe Product Code	prod_TpFpO4EkIM28wn
Limio Price	£50.00 GBP, recurring, every 1 year
Auto Renew	On

When a customer purchases this Offer, Limio will:

1. Create or match a Stripe Customer

2. Create a Stripe Price for £50.00 GBP/year linked to the Stripe Product

3. Create a Stripe Subscription

4. Process the first payment via the first invoice