Subscribe and save

Offer a product on subscribe and save and its page shows a repeat option beside the one-off price. The shopper picks how often, pays for the first order at checkout, and Tuppence makes each repeat order on the day, priced from your catalogue then, less the saving, with tax.

1. Offered10 % off every month unless you say
2. Subscribedthe first order at checkout
3. Repeatedpriced on the day, less the saving

1. Offer a product

curl -sS -X POST "https://api.tuppence.ai/v1/subscription_offers" \
  -H "Authorization: Bearer $TUPPENCE_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"product": "prod_…"}'

With only the product, the offer is 10 % off, every month, for every variant. One offer per product.

Field	Default	Is
intervals	[{"interval": "month", "count": 1}]	The choices of how often: every 1 to 12 weeks or months, up to 6 choices
discount_bps	1000 (10 %)	Off every repeat order, up to 5,000 (50 %)
first_order_discount_bps	the same	Off the first order instead
min_cycles	0	Orders a shopper agrees to before they can cancel, up to 24
variants	every variant	The variants it covers
active	true	Shown on the product page

2. Change or hide it

POST /v1/subscription_offers/{id} changes only what you send. Repeat orders already due use the new saving. active: false hides the option; shoppers already subscribed keep theirs.

What shoppers can do

From the link in each renewal email, a shopper can skip the next order, pause, swap to another variant, change the quantity, the date or the address, and cancel in two taps.

• When the next order costs more than the last, the shopper is told 7 days before.
• When a product is out of stock on the day, the order waits up to 7 days, then is skipped without a charge.
• Subscriptions need a card or wallet: payment methods that can’t be saved aren’t offered.

Over MCP and the assistant

Tool	Scope	Does
list_subscription_offers	products:read	Offers, by product or whether they show
create_subscription_offer	products:write	Offers a product. A person approves it
update_subscription_offer	products:write	Changes an offer. A person approves it, and it can be undone

Next

• Products
• Checkout