Bolt has moved to boltapp.com. Stores still using bolt.com hosts must update now: see the migration guide.

Skip to content

Flat plans

Sell a fixed recurring price charged automatically to the shopper's saved payment method.

View As MarkdownMCP

A flat plan bills a fixed amount each period. The shopper checks out once, and Bolt charges their saved payment method automatically at every renewal.

How a subscription starts

Bolt creates a subscription from a completed checkout whose cart references the plan. There are two ways to reach that checkout:

  • Hosted checkout link. Each plan on a product created with a SKU has a Bolt-hosted checkout link. Place it where shoppers subscribe. The cart Bolt builds carries the plan reference.
  • Your own checkout. Set subscription_plan_id to the plan's ID on the cart item; Bolt prices the line from the plan. Bolt creates the subscription from the completed order.

In both cases the completed order defines the subscription and its recurring amount.

What each renewal charges

The shopper pays the plan's price at signup, and Bolt bills each renewal at the plan's price. A plan cannot be edited once its product has gone live, so subscribers keep the amount they signed up at. You set the plan's price and billing frequency when you create the plan.

Example

A merchant sells a Pro membership at $9.99 per month.

  1. Signup. The shopper completes the plan's checkout link and pays $9.99. Bolt saves the payment method, creates the subscription, and sends a confirmation email.
  2. During the period. No action is required from you or the shopper. The subscription waits for its renewal date.
  3. Renewal. One month later, Bolt charges the plan's $9.99 to the saved payment method and sends a renewal email. This repeats each month until the subscription is canceled.
  4. Failed payment. If a renewal charge fails, Bolt retries on your payment recovery schedule and emails the shopper a payment update link. Updating the payment method triggers an immediate retry. If every retry fails:
    • On Bolt Cart, Bolt pauses the subscription. Paying the open renewal invoice resumes it. Retries run 1, 3, and 7 days after the first failed charge by default.
    • On other stores, Bolt cancels or pauses the subscription, depending on your setting. Retries run 24, 72, 168, and 336 hours after the failure by default.

The amount does not change on its own, the shopper takes no action in a normal period, and no integration work is required beyond placing the checkout link.

Shopper notifications lists each email Bolt sends along the way.

Trials and promotions

On Bolt Cart, set these on the plan's Trial and promotions step:

  • Free trial. 1 to 730 days. The subscription shows as Trialing until the trial ends, then renews at the plan's price. Each customer gets one free trial per product. If no card is on file when the trial ends, Bolt sends an invoice with a Pay link.
  • Promotions. Attach a promotion to discount the plan for new signups.

Trial and promotion changes apply to new signups only. Subscribers who already have a trial or promotion keep it.

Plan changes

On Bolt Cart, a subscriber switches plans by checking out the new plan with Bolt Checkout. Bolt applies the change when that checkout is paid:

  • Upgrade. Takes effect immediately, with credit for the unused part of the current period. The card used for the upgrade becomes the card on file.
  • Downgrade. Scheduled for the next renewal. Until then you (with POST /v1/subscriptions/{subscriptionId}/revoke_plan_change) or the shopper (from their Bolt account) can revoke it, and the subscriber keeps the current plan.
  • Frequency change, for example monthly to yearly. Restarts the billing period.

Canceling at the end of the period also cancels a scheduled downgrade. Bolt emails the shopper when a plan is upgraded, when a downgrade is scheduled, and when a scheduled change is revoked.

Next steps

On this page