Language
Reval runs in one language per store: Español (Argentina) (the default), Español (Latinoamérica) or Português (Brasil). The two Spanish variants differ in how they address the customer: the Argentine one uses voseo («pausá», «gestioná») and the Latin American one uses tuteo («pausa», «gestiona»). The selector switches the whole app at once —the admin, the checkout, the customer portal, the box builder and the «Mi Suscripción» section of the customer account— and the change takes effect on save, with nothing to reinstall. The default texts of the theme blocks (buy box, landing and subscription cart) follow it too: Shopify resolves them by the online store’s language, and since «Español (Latinoamérica)» doesn’t exist there, a store publishing plain «Español» used to see the widget in voseo; now, with Reval on Español (Latinoamérica) and a shopper browsing in Spanish, they come out in tuteo. Texts you typed into the block yourself are untouched. Needs the updated version of the extension (published with the app).- The texts you write yourself are not translated: plan names, box copy, buy box benefits. Write them in the language you chose.
- On install, Reval detects your store’s language and starts in it (a Portuguese store starts in Portuguese; everything else, in Spanish). Detection runs only once: if you later change the language by hand, nothing overwrites your choice.
Integrations — Mercado Pago
This is the first thing to fill in: without credentials, the subscription checkout doesn’t work.There is no OAuth connection. Credentials are copied from your Mercado Pago panel and pasted here. They’re stored encrypted in your store’s configuration, and neither the access token nor the webhook secret is shown back to you once saved.
After saving, use Test connection. If everything is fine you’ll see your Mercado Pago account name. If a name that isn’t yours appears, the token is wrong: stop and check it before going any further.
Checkout
Reval uses its own checkout, so Shopify’s native checkout field configuration doesn’t apply. These controls replicate it:
If you renamed the Company field in Shopify (for example to “Colonia”), type the same text in Nombre del campo Empresa (Company field name) so the Reval checkout shows it the same way. The value still travels in the Company field of each order’s address, as in the Shopify checkout. Empty = “Empresa”.
The defaults reproduce the checkout’s current behavior, so if you don’t touch anything, nothing changes.
Fiscal document
If you need the customer’s tax ID for invoicing (CUIT/CUIL, RUT, CPF/CNPJ, RFC…), set Ask for the fiscal document to Optional or Required:- Field name: the text the customer sees in the checkout, for example «CUIT/CUIL». Empty = «Documento fiscal».
- The field appears in the checkout below Company. If it’s required, the customer can’t continue without filling it in. Reval doesn’t validate the format.
- The value is stored on the subscription and travels on every Shopify order it generates —the first one, the renewals and the manual orders— as an order attribute, with the field name as the key (for example,
CUIT/CUIL: 20-12345678-9). - You can see it and correct it from the subscription detail, and it also shows on the customer profile.
It’s different from the document on the card form (DNI, RUT, CPF…), which goes straight to Mercado Pago to validate the payment and isn’t stored by Reval.
The checkout also adapts on its own to your store’s market, based on its currency. In stores in Chilean pesos (CLP) it asks for the ID document (RUT — it accepts the everyday format,
12.345.678-K), the address selector offers Chile’s 16 regions, and all amounts are charged and billed in whole pesos, with no decimals. In Brazilian reais (BRL) it asks for a CPF or CNPJ —with check-digit validation, to catch a typo before the payment is attempted—, the address gains the Brazilian fields (bairro, and the street número in its own box) with the postal code in CEP format (00000-000), and the selector offers Brazil’s states. In ARS it asks for DNI/CUIT as always. And for deliveries to Chile or Colombia the postal code is optional —Shopify does not require it in those countries and shipping rates are quoted by region or department—, both at checkout and when editing the address from the subscriber portal or the admin; in every other country it stays mandatory. None of this needs configuring.Taxes
Reval takes Shopify’s tax configuration at signup and locks it for the following cycles: the rate that applies to the products, whether prices already include tax, and whether the store charges tax on shipping (Shopify → Settings → Taxes, “Charge tax on shipping rates”). Every subscription order carries a tax line at your country’s nominal rate (for example 19 % or 21 %), which is what invoicing apps read. On tax-inclusive stores this does not change what the customer pays: it is what the order reports.Subscriptions created before October 2026 compute tax on the products only. If your store charges tax on shipping and you want those subscriptions to report it too, ask the Reval team: it is a one-time adjustment per store. One-time add-ons travelling on a subscription order are not yet included in the tax line.
Shipping in the checkout
The Reval checkout quotes shipping with the same Shopify rates your store uses for any purchase and groups them into Home delivery and Pickup point. It never pre-selects a pickup point: if your carrier offers branches, the customer has to pick one on purpose. The chosen method is locked for the subscription and recurs every cycle (see Free shipping and edits). If your store has rates configured and the customer enters an address Shopify offers none for, the checkout shows “Shipping is not available for this address” and does not let them pay, as the native checkout does. Only a store with no rates configured at all keeps selling with “Envío a coordinar” at $0. Shipping zones (“Zonas de envío”). Under Pedidos e inventario → Zonas de envío you can adjust what the quote returns, by delivery postal code: each rule lists codes (exact1754, prefix 17*, range 1700-1799, or * for every address) and picks an action — hide a method (whose title contains what you type), rename it (only the name the customer sees changes; the code your fulfillment app reads is untouched) or mark the zone as no coverage, which blocks the purchase with “Shipping is not available”. The rules apply everywhere shipping is quoted: the product, cart and box checkouts, and the re-quotes when a subscription is edited or reactivated. With no rules defined, nothing changes. The rules live in Reval: if you change the zones in your shipping app, update them here too.
Brand
Reval uses its own checkout, so these settings — the Marca (Brand) module — define how it looks. They apply to the checkout, the thank-you page and the box landing — always, even when the customer arrives through a direct link.
Each value follows the precedence what you set here → what the buy-box block picks up from the theme → the default. If you leave everything empty, the checkout looks as it does today. Saving validates the colour (hex/rgb) and the URLs (
https://), and the screen shows a live preview.
This is the recommended place for the checkout’s logo, colour and favicon: it takes priority over the logo you can set in the buy-box block settings and over the colour the block picks up from the theme.
Orders and inventory
Generation limits
Maximum orders per subscription per day. A safety cap against generating extra orders for the same subscription. Setting 0 leaves it unlimited. It doesn’t affect Mercado Pago’s automatic charges: those are idempotent per payment, and stopping them would mean losing orders that were already paid for. Maximum new subscriptions per customer per day. An anti-abuse control at checkout, for the pattern of opening several discounted subscriptions on the same day and cancelling them before the second charge. It counts every subscription created in the last 24 hours, including cancelled ones. Setting 0 leaves it unlimited.Combined orders (auto-merge)
If a customer has several subscriptions with the same shipping address and their charges fall a few days apart, Reval can ship them in a single Shopify order (one shipment) instead of one per subscription. Combine into one order the subscriptions of the same customer that are charged together. Off by default. When you turn it on, the window appears: combine subscriptions charged up to N days apart (empty = 1 day). How it works: when a subscription’s cycle is charged and the same customer has another active subscription, with the same address, whose charge falls within the window, the order for the first charge waits for the second. When that second charge arrives, both cycles ship in a single order taggedPedido combinado, with one shipping line per subscription and each product marked with its subscription’s frequency. If the second charge doesn’t arrive within the window, is rejected, or the other subscription stops being active, the held order ships on its own.
Charges don’t change. Mercado Pago debits each subscription on its own date and for its own amount; what gets combined is the order and the shipment. The combined order’s total is always the sum of the charges. That’s why the wait can delay that shipment by up to the length of the window — choose a short window if your operation ships same-day.
Dynamic boxes are not combined. The combined order appears only once in Orders and in the customer’s profile, and each subscription’s history records «Pedido combinado con …» (combined with …).
Free shipping on subscriptions
Reval quotes each subscription’s shipping with the same Shopify rates your store uses for any purchase, and Shopify can’t tell a subscription from a one-time purchase. If you set up free shipping in Shopify, you give it away on every sale. This option lets you offer “subscribe and shipping is free” without touching one-time purchases. Ofrecer envío gratis en las suscripciones (offer free shipping on subscriptions). Off by default. When you turn it on, the shipping method the customer picks in the Reval checkout comes out free: the first charge and every renewal go without a shipping cost. It also applies to the box builder’s checkout and to reactivating a subscription. Each cycle’s Shopify order keeps the shipping line at $0 with the method’s name, so your fulfillment (and your shipping app) keeps seeing the same method as always. Monto mínimo por entrega para envío gratis (minimum per delivery for free shipping, optional). It is a money amount, in the store’s currency — not a number of items. Empty = always free. If you enter an amount, shipping is free only when the delivery’s product total (without shipping) reaches that minimum; below it, the Shopify rate is charged as usual. The minimum is in the store’s currency and is compared against the plan’s regular price: the first-order discount doesn’t count, a fixed discount agreed for the subscription does.Edits follow the rule. If a customer changes quantities or products from the portal (or you do from the admin) and the subscription stops meeting the minimum, shipping is charged again from the next cycle and the portal’s breakdown shows it. If an edit takes it above the minimum, it becomes free from the next cycle. Mercado Pago never changes a charge in progress.
Existing subscriptions don’t change on their own. The option applies to new subscriptions and to those edited after you turn it on; the ones that already existed keep the shipping they had until their next edit. The same when you turn it off: a subscription created with free shipping keeps it until it is edited. One-time purchases in the Shopify checkout are never affected.
Free shipping applies to the method the customer picks, including the more expensive ones (for example, express). If you offer several methods and don’t want to give away the most expensive one, leave only the ones you want to cover available in Shopify for those products. To show the benefit in the buy box, add it to the block’s benefits text.
Out-of-stock products
What to do when it’s time to create the cycle’s order and stock is missing. The customer has already been charged by Mercado Pago, so there’s no consequence-free option:The retry option has an attempt cap, after which the cycle is marked as exhausted and stops being retried. You can see this in the subscription detail.
Products without inventory tracking (“Don’t track inventory” in Shopify): they can be subscribed to and their orders are created normally under any of these modes. Reval only considers a variant out of stock when its policy is “deny” and its tracked quantity is zero or less — an untracked product always counts as available (and, having no inventory, its orders don’t deduct anything).
Which products are offered as add-ons and which can be swapped into or added to a subscription isn’t defined here but per product, in Products.
Allow skipping the next delivery
Adds a “Skip” button to the customer portal: it omits one delivery without cancelling or pausing the subscription, designed for the customer who has built up product and would otherwise cancel. It’s off by default. Before turning it on it’s worth knowing how it works under the hood, because it has a visible consequence:Only one delivery can be skipped at a time, and —just like pausing and cancelling— the option doesn’t appear until the customer completes their plan’s minimum delivery commitment, if the plan has one. While the skip is in progress the customer sees “Cancel skip”, which puts them back on the normal schedule.
The skip emits the “Cycle skipped” event (not “Subscription paused”), so your winback flows don’t chase someone who just had product to spare.
Abandoned checkouts and carts
Record Reval’s abandoned checkouts and carts. Off by default: this is personal data of people who did not buy, and while it is off nothing is saved or emitted. When it is on, a customer who types their email in Reval’s checkout and does not finish paying shows up in Orders → Abandoned checkouts with their details, the products and a link to resume the purchase, and the “Checkout started” event goes out to Klaviyo and to webhooks. The subscription cart is recorded under the same option (“Cart started”) when Reval knows who the customer is. Records are deleted after 90 days without activity. What gets saved, the list’s statuses and how to build the recovery email: Abandoned checkouts.Portal banner
An image shown in the portal, above the subscription cards and inside each one. It’s designed so that all the text and the call to action come inside the image — Reval doesn’t overlay text on top.Integrations — Klaviyo
Reval can emit the subscription lifecycle events so you can build welcome, recovery or winback flows. The fifteen that are sent: Subscription created · Subscription charge · Failed charge · Upcoming renewal · Product out of stock in subscription · Product available again · Product deleted in subscription · Subscription paused · Subscription resumed · Subscription cancelled · Subscription ended · Payment method updated · Surprise applied · Cycle skipped · Combined order With Abandoned checkouts and carts on, three more events are added that have no subscription yet: Checkout started, Cart started and Cart emptied (emitted as «Checkout iniciado», «Carrito iniciado» and «Carrito vaciado» in Spanish stores). How to build the recovery flow with them: Abandoned checkouts.Inside Klaviyo the metric names and the human-readable properties of each event (the frequency label, the next charge date, the reason behind a failed charge, a pause or a cancellation) follow the store’s configured language: Spanish («Suscripción creada», «Cobro de suscripción», «Cobro fallido», «Renovación próxima», «Producto sin stock en suscripción», «Producto disponible nuevamente», «Producto eliminado en suscripción», «Suscripción pausada», «Suscripción reanudada», «Suscripción cancelada», «Suscripción finalizada», «Medio de pago actualizado», «Sorpresa aplicada», «Ciclo saltado», «Pedido combinado») for stores in Argentine or neutral Spanish, and Portuguese («Assinatura criada», «Cobrança de assinatura», «Cobrança falhada», «Renovação próxima», «Produto sem estoque na assinatura», «Produto disponível novamente», «Produto excluído na assinatura», «Assinatura pausada», «Assinatura retomada», «Assinatura cancelada», «Assinatura finalizada», «Meio de pagamento atualizado», «Surpresa aplicada», «Ciclo pulado», «Pedido combinado») for stores in Portuguese. That is what you pick in the flow builder. In Klaviyo the metric name is the event’s identity: if you change the store language, events start arriving under the new name and the flows bound to the old one stop firing until you rebind them. The raw properties used in conditions (
status, frequency_type, amounts, ISO dates, reason_key) do not change with the language.Renewal reminder
The “Renewal reminder (days before the charge)” field makes Reval emit the “Upcoming renewal” event that many days before the next charge, once per cycle, through a daily process. It’s the raw material for the “we’ll charge you in N days” email — which reduces declines and disputes. At 0 it’s disabled, and it’s only sent if Klaviyo or Shopify Flow are enabled.Shopify Flow
You can also enable the Subscription event trigger for Shopify Flow, and build your automations there: a workflow with that trigger and a condition on the event (for example,event = cancelled) can send an email with Shopify Email or tag the customer. It’s off by default, so no extra call is made until you enable it.