The plan type
The first thing you choose when creating a plan is its type, and it can’t be changed afterwards:
A dynamic-box plan carries no tied products: the eligible products, the sizes and the volume discounts are defined on the box, in the Boxes section. For the same reason, it has no “Apply to subscribers” either: each box’s price is recalculated when it’s edited. The discount accepts 0 to 99 (0 is valid — the box can discount through its own tiers alone), and when you edit it, it applies to new purchases and to each box’s next edit.
In the list, each group carries its type badge: Caja dinámica or Suscribí y Ahorrá.
Plan groups
The unit you work with is the plan group: a title, an interval and a pricing mode, to which you then tie as many variants as you like. The advantage is that you define the terms once. If you have twenty products with a monthly subscription at 15% off, that’s one group with twenty variants tied to it — not twenty separate configurations.The two pricing modes
Creating a plan
1
Open Plans
From your Shopify admin, go to Apps → Reval → Plans.
2
Create the group
Define the title, the interval (number + unit: days, weeks or months) and the pricing mode — percentage discount or fixed price. The title is internal, but the subscriber sees it as the debit’s description in Mercado Pago.
3
Choose how it's shown in the store (optional)
The Name on the product page field controls the plan selector’s text in the buy box. Left empty, the frequency is shown (e.g. “Monthly”); filled in, your text is shown (e.g. “Coffee Club”) with the frequency still visible underneath — the customer never subscribes without seeing how often they’ll be charged.
4
Tie the variants
Add the product variants that will be offered on these terms. Each tied variant gets its own price template in Mercado Pago.
5
Check on the storefront
Open the page of one of those products: the buy box should already show the subscription option.
Weeks are a display unit: Mercado Pago only understands days and months, so a weekly frequency is converted to days by multiplying by seven. The behavior is the same.
First-order discount
The Extra discount on 1st order (%) field is optional and applies only to the first charge of each new subscription. It’s there to win the first purchase without lowering the price of every renewal.- It’s calculated on the list price and replaces the plan’s discount on that first order: the two don’t add up. Example: a $40 product on a 10% plan with a 20% first order is charged $32 the first time and $36 from the second charge onward.
- On a fixed-price plan, the percentage is applied to that fixed price.
- The first order is never more expensive than a renewal: if the first-order percentage is lower than the plan’s, the plan price is charged.
- 0 or empty = no first-order discount.
When editing a group, a change to this discount applies to new subscriptions. Those that already went through their first charge aren’t affected.
Cycle limits (minimums and maximums)
When creating or editing a plan you can define two optional limits, both expressed as a number of charges:- Minimum cycles — a commitment period. Until that number of charges is completed, the customer can’t pause or cancel from their portal (they see the reason and how many are left). You can always cancel from the admin, with no restriction.
- Maximum cycles — a defined duration. After charge number N, the subscription stops charging on its own: Reval cancels the mandate in Mercado Pago and emits the “Subscription ended” event to Klaviyo / Shopify Flow for the closing email. The status stays Active (the same criterion as Skio): the ending is communicated with the “Cycles completed — no further charges” notice in the admin and in the customer portal, and it’s recorded in the history.
The limits are stored on the plan: editing them also applies to that plan’s existing subscriptions, both for the pause/cancel block and for the automatic ending.
Changing a plan’s price
This is the part that causes the most confusion, so it’s worth being explicit: For the change to reach existing subscribers you have to run Apply to subscribers from the group. That action walks through that group’s subscriptions and updates the mandate amount in Mercado Pago, taking effect from the next cycle — a charge that already happened is never touched. Every change is recorded in the subscription’s price history.Managing existing plans
Duplicating a group
To create a plan almost identical to another one — the same discount at another frequency, or another discount for the same products — click Duplicar (duplicate) on the group (archived ones too, by ticking “Mostrar planes inactivos”). The create form loads with the original’s configuration: type, name as “Copia de …” (copy of), product-page name, frequency, pricing mode and discount, first-order discount, minimum and maximum cycles, and the products. Change whatever you want, including the frequency and the type, which can’t be edited on an existing plan, and click Crear plan. Nothing is created until then: if you close the screen, no new plan is left behind and the original stays as it was. A dynamic box plan is duplicated with its type, frequency and discount, without being linked to any box: assign it in Boxes. An archived group you duplicate stays archived; the new one is active.Editing a group
You can change the title, the name on the product page and the pricing terms. Not the interval. Price changes are written to every tied variant, but remember they don’t reach subscribers until you use “Apply to subscribers”.Removing a variant
Takes that variant out of the group. The product stops offering a subscription in the buy box if it has no other active plan left. Existing subscriptions for that variant keep being charged normally and their owners keep full portal self-service (change quantities, pause, cancel). If the variant has active subscribers, the confirmation shows you how many before removing.Archiving a group
Plans aren’t deleted, they’re archived. The group stops being offered on the storefront and disappears from the list, which by default shows only active ones. If the group has active subscribers, the confirmation shows you how many — archiving only stops new signups.Archiving does not cancel or pause any subscription. Anyone already subscribed on that plan continues their normal cycle and keeps full portal self-service: changing quantities, pausing, cancelling, and even reactivating a subscription cancelled over failed payments. The only thing they can no longer do is add the archived plan to another subscription. If you need to act on them, go to Tools.
Products marked “Not synced with MP”
Every variant tied to a plan needs its price template in Mercado Pago. If Mercado Pago refused to create it, the variant stays in the plan with the “Not synced with MP” label, and the screen’s notice, the label and its tooltip say why: which product was left out, what amount Mercado Pago would see and what the limit or problem is. The most common causes:- Amount under Mercado Pago’s minimum. MP does not accept recurring charges under ARS 15 in Argentina or CLP 950 in Chile. If a product’s discounted price falls below, Reval refuses it when you tie it and tells you right there (“Coco Crunch was left out: with the discount the charge would be 950”). Raise the price, lower the discount, or sell it inside a pack or a box.
- Missing or invalid credentials. Load or verify them in Settings.
- A one-off refusal from Mercado Pago, which the notice reproduces verbatim.
Reactivating a group
An archived group can be turned back on: tick “Show inactive plans” in the list and use Reactivate. The group and the variants still tied to it go back to active, and the plan is offered again on the product pages and boxes that use it. Variants you tied to another plan (or removed) in the meantime are left untouched.If a product doesn’t show the subscription option
Check in this order:- That the variant is tied to an active plan group
- That the group isn’t archived
- That the buy box block is present in the product’s theme