> For the complete documentation index, see [llms.txt](https://docs.limio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.limio.com/integrations/stripe-billing-integration/manage-pricing/using-limio-price-with-stripe.md). # Using Limio Price with Stripe {% hint style="info" %} This article covers pricing for subscription products using Stripe Billing. * For setting up the Stripe Product Code, see [Stripe Product Code](/integrations/stripe-billing-integration/manage-pricing/stripe-product-code.md) * For one-time products, see [How to Configure a One-Time Offer](https://docs.limio.com/product/pricing/what-are-offers-and-how-to-configure-them/how-to-configure-a-one-time-offer) {% endhint %} ## 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](/integrations/stripe-billing-integration/manage-pricing/stripe-product-code.md) 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. {% hint style="info" %} Billing anchor dates can be customised further using the `beforeStripeSubscription` plugin hook — see [How Limio Events Update Stripe](/integrations/keeping-stripe-and-limio-in-sync/how-limio-events-update-stripe.md). {% endhint %} ## 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 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.limio.com/integrations/stripe-billing-integration/manage-pricing/using-limio-price-with-stripe.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.