Shopify is the single source of truth. Every approved charge generates a real Shopify order with its product lines, shipping cost and taxes calculated live. There is no parallel database and no “phantom” orders: what you see in your Shopify admin is what was actually charged and will ship.
Full subscription flow
- Merchant view
- Subscriber view
What happens in your store
As a merchant, your main interaction with Reval happens at two moments: the initial setup (plans, discounts, frequencies) and reviewing reports. The day-to-day runs automatically.Subscription signup
1
The buyer picks a plan in the buy box
A plan selector appears on the product page with the frequency (weekly, monthly, bimonthly, etc.) and the discount attached to each one. The buyer selects the plan and clicks “Subscribe”.
2
Reval custom checkout
The buyer enters their card details directly in Reval’s checkout. Tokenization happens in the browser, with no redirect to Mercado Pago. Reval’s server never sees the full card number.
3
Creating the open-amount recurring charge mandate
Reval creates a recurring charge mandate (preapproval) in Mercado Pago using the open-amount modality — that is, without tying it to a fixed Mercado Pago plan. This is essential because a mandate tied to an MP plan can only charge a fixed amount, with no ability to add shipping, taxes or per-customer discounts. With an open amount, each cycle charges the exact amount (product + shipping + taxes) queried live against your store’s real Shopify rates.
4
First charge and Shopify order
The first charge runs immediately. When Mercado Pago confirms the payment via webhook, Reval creates the first Shopify order with all the lines, shipping and taxes. That order enters your normal fulfillment flow.
Recurring cycle
1
Automatic charge through the mandate
On the cycle date, Mercado Pago executes the charge using the active mandate. The amount is the one set on the mandate —product, shipping and tax calculated at signup time— and it only changes if someone explicitly updates it from the admin or the portal.
2
MP webhook reaches Reval
Mercado Pago notifies the result of the charge (approved or declined) via a webhook. Reval verifies idempotency: if the event was already processed, it discards it without creating a duplicate order.
3
Order created in Shopify (approved charge)
If the charge was approved, Reval immediately creates a Shopify order with the subscription’s current lines, the shipping cost and taxes. The order is available for fulfillment right away.
4
Declined charge
Reval logs the failure with its reason and shows it in the admin and in the portal. Mercado Pago retries the charge on its own; if the retries run out, it cancels the mandate and Reval marks the subscription as cancelled. No order is created until there is an approved charge.
Security and reliability
Reval is designed so that every operation is safe and doesn’t leave inconsistent states behind:Tokenization in the browser
Card details never pass through Reval’s servers. The Mercado Pago SDK tokenizes directly in the buyer’s browser.
Idempotent webhooks
Every Mercado Pago event is processed exactly once. If the webhook arrives duplicated, Reval detects it and doesn’t create an extra order.
Signed links
The portal and the checkout use cryptographically signed links. Without the right signature, there’s no access.
Orders that don't get lost
If a charge is approved but the order can’t be created —because a product went out of stock, for example— it’s queued and a daily process retries it until it succeeds. The customer already paid: their order doesn’t fall through the cracks.