Skip to content

Subscription billing

This page describes what the merchant sees. Money flows through the shop’s own merchant account at the chosen provider; Neocarts only initiates charges against the saved card token.

  1. The shopper pays for the order on the payment provider’s page inside the widget.
  2. On success the provider returns a card token. For every subscription line an active subscription is created with the price, quantity and discount percentage stored on it; the next charge is one interval away.
  3. The order becomes paid; the shopper receives the paid-order email (and the account email if this is their first order); shop users receive “New subscription”.

When a charge date arrives, Neocarts creates one new order per period from the subscription’s stored price, quantity and discount plus the product’s current title and image, and charges the token.

  • Success → the order is paid, the next charge moves forward by the interval. The shopper receives “Subscription renewed — order :number” with the next charge date; shop users receive “New order :number” (when the toggle is on).
  • A charge with no answer from the provider for more than a day is marked expired and counted as a failure.
Attempt What happens
1–4 failed Next attempt a day later. The shopper receives “We could not charge your subscription” naming “attempt N of 5” and the next date.
5 failed The subscription is paused (never cancelled) with reason charge_failed. The shopper receives “Subscription paused”.

When no usable card exists at all — no token saved, token belongs to another provider, or the shop cannot take payments — the subscription is paused immediately with reason no_card.

After a charge_failed or no_card pause the shopper can replace the card themselves and resume the subscription.

3 days before a charge the shopper receives “Reminder: charge on :date” with the amount and the product. One email per charge date.

PUT /v1/shop/products/{external_id}/price (or the button on the product page in the panel) updates the price on active and paused subscriptions for that product; cancelled ones are untouched. Each subscription keeps its own discount percentage, so discounted_price is recomputed with the formula. It applies from each subscription’s next charge; an order already issued and awaiting payment is not repriced — at the next charge attempt it is cancelled and a new one is created. Every shopper receives “The price in your subscription changed” with the next charge date.

Every action is available in the shop panel. Some of them — skipping a delivery, frequency, pause, resuming from a pause, cancelling, the address and the card — the shopper can do themselves.

Action Rule
Pause Optionally with a paused_until date; on that date the subscription resumes automatically.
Resume Next charge is the stored date if it is in the future, otherwise today. Charges missed during the pause are not owed.
Cancel In a panel the reason is required (see the list), comment optional.
Reactivate A cancelled subscription can be returned to active.
Reschedule Changes the next charge date. Not available on a cancelled subscription — reactivate first.
Quantity Changes the quantity on the subscription.
Delivery address Changes the method and address; the method must be enabled for the shop.

Subscription statuses and allowed transitions are in Statuses. All emails are in Emails.