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.
First payment
Section titled “First payment”- The shopper pays for the order on the payment provider’s page inside the widget.
- On success the provider returns a card token. For every
subscriptionline anactivesubscription is created with the price, quantity and discount percentage stored on it; the next charge is one interval away. - 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”.
Recurring charges
Section titled “Recurring charges”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
expiredand counted as a failure.
Retries
Section titled “Retries”| 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.
Reminder
Section titled “Reminder”3 days before a charge the shopper receives “Reminder: charge on :date” with the amount and the product. One email per charge date.
Repricing
Section titled “Repricing”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.
Managing from the panel
Section titled “Managing from the panel”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.