Getting started with Reval: install and set up your store
Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.
Reval installs directly into your Shopify admin and requires no code changes or additional infrastructure. Follow this step-by-step guide to get your store ready to sell recurring subscriptions charged through Mercado Pago.The Reval dashboard walks you through it: while any setup is still missing you’ll see the “Getting started” card with the real status of each item (credentials saved, webhook verified, first plan created and billing card added) and a direct link to this guide. Each item ticks itself as soon as you complete it, without reloading the page, and the card disappears on its own once everything is ready.
Reval requests the following permissions in your Shopify store at install time:
Read: orders, products, taxes, shipping rates and customer data.
Write: creating and updating recurring orders.
These permissions are strictly necessary to generate the automatic charges and to calculate shipping and taxes in real time during checkout.
1
Install the app with your install link
Reval is a custom distribution app: it isn’t published on the Shopify App Store. You’ll receive an install link generated specifically for your store.Open it with the store owner’s session and accept the permissions. Once installed, Reval appears under Apps inside your admin, embedded — there’s no external site to log into.
The link is anchored to your store’s domain and only works for that store.
2
Enter your Mercado Pago credentials
Reval needs access to your Mercado Pago account to create the recurring charge mandates and to receive the notification for every charge.There is no OAuth connection: credentials are copied from the MP panel and pasted into Reval, where they’re stored encrypted for your store.
Everything that follows happens in the Mercado Pago developer panel, inside your application. If you haven’t created it yet, step 2.0 guides you; if you already have it, skip straight to 2.1.
Create a new application dedicated to Reval. Don’t reuse the one you use to charge in your checkout.For two reasons:
Each application is created for one Mercado Pago product. A checkout application does not enable the Subscriptions APIs, which are the ones Reval needs for recurring charges.
Each application allows only one webhook URL per mode. If you paste Reval’s URL into an application that already has a webhook configured, you overwrite it — and your checkout’s notifications stop reaching where they were going, with no warning at all.
Having two applications does not separate your money or your accounts: both belong to the same Mercado Pago account and everything is credited in the same place. An application is an integration credential, not a wallet. There’s no cost and no limit.
If you sell with Mercado Pago but have never been into the developer panel, you probably don’t have an application of your own: Shopify’s payments integration is linked from the store admin, without going through there. In that case, just create your first one.
Go to the Mercado Pago developer panel with the MP account that will charge the subscriptions. Use your own country’s domain (.com.br, .com.mx, .cl, and so on). At the top right, click Integraciones (Integrations).
The Mercado Pago panel is shown in the language of your account’s country, so the labels below are given in Spanish — exactly as they appear in the screenshots — with the English meaning in parentheses.
Open Integraciones in the developer panel
In Gestión de integraciones (integrations management), click + Crear aplicación (Create application).
Integrations management — Create application
Choose Crear en el panel de integración (create in the integration panel), not «Crear con IA» (create with AI): it’s the option that creates the app and gives you access to the credentials.
Create in the integration panel
Under Elegí una solución para integrar (choose a solution to integrate), select Suscripciones (Subscriptions — “Automatiza cobros recurrentes en tu sitio”).
Choose the Suscripciones solution
This is the change from Mercado Pago’s previous flow: it used to be Pagos online → Con un desarrollo propio → Checkout API. Suscripciones is now a dedicated solution and the right one for Reval — it enables the recurring-charge APIs.
Open Otros datos (other details), fill in the Nombre de la aplicación (application name, e.g. “Reval - Suscripciones”), tick the personal data authorization and click Crear aplicación.
Other details — name and authorization
Open the newly created application from Gestión de integraciones and, in the side menu, scroll down to PRODUCCIÓN → Credenciales de producción. The first time, Mercado Pago asks you to activate the credentials before showing them: pick the Industria (industry) that best describes your business, enter your store’s Sitio web (website, with https://), tick the personal-data authorization, solve the “No soy un robot” reCAPTCHA and click Activar credenciales de producción.
Activating the production credentials
Until you complete this step the screen shows neither the Public Key nor the Access Token.
With the credentials activated, carry on with step 2.1.
In the side menu, go to NOTIFICACIONES → Webhooks (Notifications → Webhooks). Make sure you’re on the Modo productivo (production mode) tab and not on “Modo de prueba” (test mode): they’re two independent configurations and the test one isn’t used.
Webhook configuration in production mode
In URL de producción (production URL), paste the notifications URL (webhook) that Reval shows you in Settings → Integrations — Mercado Pago (there’s a Copy URL button next to it). The URL already comes built for your store — there’s no need to edit it.
The ?shop= at the end is not optional: it’s what tells Reval which store the notification comes from and which secret key to validate it with. If you omit it, Mercado Pago still responds 200 and everything looks fine, but you’re relying on a fallback mechanism. Copy the full URL, exactly as Reval shows it.
Under Eventos recomendados para integraciones con Suscripciones (events recommended for Subscriptions integrations), tick exactly two:
Planes y suscripciones (plans and subscriptions)
Pagos (legacy) (payments, legacy)
Don’t tick any others. Extra events don’t break anything, but they generate traffic that Reval discards.
Copy the Clave secreta (secret key) shown at the very bottom. That’s the third value you’ll paste into Reval.
Click Guardar configuración (save configuration).
The refresh button next to the secret key generates a new one and invalidates the previous one. If you click it after having configured Reval, webhooks start failing signature validation and charges stop generating orders in Shopify. If that happens, copy the new key and update it in Reval.
The name “Pagos (legacy)” sounds like something discontinued, but it’s the right event: it’s the one that notifies each individual charge on the mandate, and it’s the one Reval listens to in order to create the Shopify order.
In Reval, go to Settings → Integrations — Mercado Pago and fill in:
Public key (starts with APP_USR)
Access token (starts with APP_USR)
Webhook secret — the secret key from the previous step
Save.
The access token and the webhook secret aren’t shown again once saved: the fields stay masked. That’s the expected behavior. If you need to change them, type the new value over the top and save again.
Click Test connection. The test uses the saved credentials, so save before testing.If everything is fine, a green message appears with your Mercado Pago account name and your country code (MLA Argentina, MLB Brazil, MLC Chile, MCO Colombia, MLM Mexico, MPE Peru, MLU Uruguay).
What you see
What it means
”Connection OK — your account (MLA)“
Done, move on to the next step.
”Mercado Pago rejected the access token”
The token is incomplete or is a test one. Copy it again from Credenciales de producción.
Connection OK but with a different account name
Stop here. See the warning below.
If the name shown isn’t your account’s, the access token belongs to another account: stop right there. A wrong token doesn’t throw an error, it would simply charge into the wrong account.Bear in mind as well that Reval operates with production credentials: there is no sandbox mode, and MP’s test cards don’t work. To validate the flow, you make a real low-value purchase and refund it afterwards.
The previous step tests your credentials; this one confirms that Mercado Pago’s notifications reach Reval and validate correctly. It’s what the Reval dashboard tracks as “Webhook de Mercado Pago” on the “Primeros pasos” (Getting started) card: it stays pending until Reval receives a valid notification.
In the MP panel, go back to NOTIFICACIONES → Webhooks → Modo productivo (where you set the URL in step 2.2).
Click Simular notificación (Simulate notification) and send a test one (for example, of the Pagos / Payments event). MP sends it to your URL, with the ?shop= and signed with the secret key.
Back in the Reval dashboard, under Primeros pasos (Getting started), the “Webhook de Mercado Pago” item changes to “último recibido: …” (last received) with the date. That’s it validated.
Save the three values in Reval first (step 2.3): the notification validation uses the saved secret key. If you simulate before saving it, the signature won’t validate and the step won’t tick.
3
Create your first subscription plan
Plans define the charge frequency and the discount subscribers get relative to the list price.
Head to Plans in Reval’s side menu and fill in the Create a subscription plan section.
Complete the fields:
Plan name: for example, “Monthly” or “Quarterly with discount”.
Frequency: combine a numeric interval with a time unit — days, weeks or months. For example: 1 month for monthly billing, 3 months for quarterly, 14 days for fortnightly.
Discount type: percentage discount (between 1 and 99, off each product’s list price) or fixed price (the same amount for every product in the plan). If you don’t want to apply a discount, use fixed price with the product’s normal price.
Extra discount on 1st order (optional): a percentage that applies ONLY to the first charge, calculated on the list price. It replaces the plan’s discount on that first order — it doesn’t add to it. From the second cycle onward the plan’s normal price is charged, and the buyer sees both prices before subscribing. More detail in Plans.
Select the products and click Create plan.
Mercado Pago has a minimum amount per charge (it depends on your account’s currency). Reval won’t let you save plans whose final price falls below that minimum, and it shows you the exact value when you try — if you see that notice, raise the price or lower the discount.
You can create as many plans as you need. Buyers will see them as options in the product’s buy box.
4
Add the Reval block to your theme
The buy box is the widget that appears on the product page and lets the buyer choose between a one-time purchase and subscribing. You add it as an app block from the theme editor — no code required:
In Shopify: Online Store → Themes → Customize.
Open a product page and, in the product information section, click Add block → Apps → “Reval”.
Save. The block positions itself next to the purchase buttons (quantity → options → subscribe button), wherever you leave it.
From the block’s settings you can edit the benefits shown when the subscription is selected and turn on pre-selection of the subscribe option. The “Mostrar opción de compra única” setting (show the one-time purchase option, on by default) controls whether the buy box offers buying without a subscription: turn it off to sell the product by subscription only. With “Orden de las opciones” (option order) you choose which option renders first — “Compra única primero” (one-time first, as shipped) or “Suscripción primero” (subscription first), for brands that sell mainly by subscription; the order doesn’t change which option starts selected, that remains the pre-selection setting’s job. The checkout’s logo, accent colour and favicon are set centrally in Reval’s Marca (Brand) module.The block also has style settings so it matches your theme’s buttons and cards: Tipografía (typography: a custom font for the whole block, button included), Botón «Suscribirme» (the subscribe button: colour, text colour, corner radius and font size; on box pages it applies to the “Armá tu caja” button) and Tarjetas de opción (option cards: border colour and thickness, card background and radius, border and background of the selected card, colour of the selection circle, discount badge colours and the colour of the “Ahorrás $…” savings line). A single «Tamaño del texto» (text size) control, 70 to 150 % with 100 as shipped, grows or shrinks every text in the block at once while keeping the proportions, for themes with large or small type. Anything you leave empty or at 0 takes the theme’s value, so there’s nothing to touch to get started. If you also use the subscription cart and style the button from there, the block’s setting wins.
Browser tab icon: set it in Reval’s Marca (Brand) module (Favicon field). If you leave it empty, Reval uses the checkout logo, and as a last resort your store’s square logo in Shopify (Settings → Brand → Square logo, a separate setting from the theme’s favicon); if that isn’t uploaded either, Reval adapts your main logo into a square.
The buy box only appears on products that have an active plan — on the rest the block is invisible, so it’s safe to add it to the general product template.
Buy box preview with the subscription option active
Want to sell subscriptions from a landing page? Reval ships a second block, “Reval · Sección de suscripción”, for any page that is not a product page — a landing, the home page, a “Subscribe” page. The buyer picks the product, the variant, the quantity and the frequency, and subscribes right there:
In the theme editor open the page (for example Pages → your landing) and add an Apps section (or any section that accepts app blocks).
Add block → Apps → “Reval · Sección de suscripción”.
In the block settings pick the products (up to 12). With two or more, the buyer sees one card per product; if the product has variants, they show up as buttons to choose from.
Optional: short names for the cards (one per line, in the order of the list — “Orange” instead of “Electrolytes Orange x30”), a heading for the product list, a heading, an intro text, benefits and the button label.
Optional, for the product image:
Show the product image: turns the image next to the cards on or off.
Pin the image while scrolling: on wide screens, the image and the cards follow the scroll while the right-hand column is read. It has no effect on phones.
Image fit: Crop to fill the frame (may cut the edges) or Show in full (no cropping), with space around it if needed.
On phones, the product cards form a row that slides sideways. If the buyer switches product, the option they had already chosen (for example, the size) is kept when the new product has it in stock; otherwise, the new product’s own option is used.This block is subscription-only (no one-time purchase) and is not offered on product pages — use the “Reval” block there. If a product in the list has no active plan, the button is disabled with a notice: assign it a plan in Plans or remove it from the list. If you pick a Reval box, the button leads to the box builder.Want buyers to add several subscriptions and pay for them together? Turn on the subscription cart, an app embed that ships turned off:
In the theme editor open App embeds in the sidebar.
Turn on “Reval · Carrito de suscripciones” and save.
With the cart on, the “Reval” block’s button reads «Agregar al carrito» (add to cart): the product goes into a dedicated subscription cart, which opens as a side panel, instead of going straight to the checkout. There the buyer sees each product with its delivery frequency, the subscription savings and the first-order price, and pays for everything with «Continuar al pago» (continue to payment), entering the card only once.
Before adding a product, Reval checks that it can be subscribed to (an active plan at that frequency, stock and the maximum new subscriptions per day). If it can’t, it shows the same notice as the checkout.
Each frequency is one subscription. Mercado Pago charges each subscription at a single frequency, so a cart with monthly and bi-monthly products creates two subscriptions. The buyer pays only once when subscribing, but from then on sees one debit per frequency. The cart says so before payment.
The subscription cart is separate from the store’s cart: one-time purchases are still paid in the Shopify checkout. The cart explains this above the products and notes at the bottom that store coupons apply to one-time purchases only.
Products are saved in the buyer’s browser until they pay or remove them.
In the embed’s settings you can choose:
Floating button: shown on every page when the cart has products, bottom right or bottom left.
Typography: by default the cart uses the theme’s. You can pick a custom font and font size for the whole cart.
Style: button colour and button text colour, cart background, text colour and button corner radius. Empty or 0 = the theme’s value. Fill them in only if you want to force another one.
Buttons individually: “Agregar al carrito” (the one that replaces the block’s “Suscribirme” while the cart is on), “Continuar al pago” and the floating button each have their own colour, text colour, corner radius and font size, which override the Style group. If you also styled the button from the “Reval” block on the product page, the block’s setting wins.
Texts: the cart title, the separate-carts notice and the coupon note. Empty = default text.
Notice in the store’s cart: adds a message to the theme’s cart explaining that subscriptions are paid separately, with a «Ver mis suscripciones» (see my subscriptions) link. It depends on the theme: if it doesn’t show up or lands somewhere odd, turn it off.
With the embed off everything works as before: the button goes straight to the checkout. The “Reval · Sección de suscripción” block on landing pages always goes straight to the checkout.
The buy box requires your store’s theme to have JavaScript enabled. If you use a heavily customized theme or one with blocked scripts, check that the widget loads correctly before publishing it.
5
Add the portal link to the customer account
Reval includes a block for Shopify’s customer accounts that gives every subscriber a direct link to the portal from their account — where they can pause, swap products, update their address, review orders and cancel. The block ships with the app; you just add it in your customer account editor.
It works with Shopify’s new customer accounts, not the classic accounts.
In Shopify: Settings → Customer accounts and open the customization editor for the account pages (Customize button).
Go to the Profile page and click Add block → Apps → “Mi Suscripción” (the Reval subscription block).
Save.
The subscriber now sees a “Mi Suscripción” item in their account navigation; opening it shows a link that takes them straight to the portal, already signed in through their session — no extra details needed. The heading and link text follow the language you picked in Settings → Language.
If “Mi Suscripción” doesn’t appear in the list of app blocks, the extension hasn’t been deployed to your store yet. Ask your Reval contact to publish it — it’s distributed with the app, not installed separately.
6
Run a test subscription
Before announcing the feature to your customers, verify that the full flow works end to end.Since Reval operates with production credentials, the test is done with a real card and a small amount, which you refund afterwards. It’s worth creating a cheap temporary plan for this.
Open the product page where the buy box appears in an incognito window.
Choose the test plan and complete the checkout with a real card.
Verify that:
The order appears under Orders in the Shopify admin, with the Subscription, First purchase and Cycle 1 tags.
The subscription appears under Subscriptions in Reval, in active status.
The mandate shows up in your Mercado Pago panel.
Cancel the test subscription and refund the charge from the MP panel.
If you also offer add-ons, tick one in the test checkout: verify that two separate charges appear in Mercado Pago (the mandate’s and the add-on’s) and that the order includes both lines.
7
Add the billing card
Until you add the card Reval is paid with, your store is in setup mode: the admin works normally, but the store only accepts a few test subscriptions — just enough for the purchase in the previous step. The dashboard shows you how many you’ve used.Go to Billing → Payment method, click Add card and save it. With that, the store moves to production and accepts subscriptions with no limit. What’s charged and how is covered in Billing.
Before launching your subscription program, keep the following current Reval restrictions in mind:
There is no on-demand charging: you can’t start a manual charge outside the scheduled cycle. Charges are executed automatically by Mercado Pago on the scheduled date.
Skipping a cycle exists, but with an approximate date: it’s enabled from Settings → Orders and inventory, and under the hood it works by pausing the debit and reactivating it one cycle later, so the date of the following charge is decided by Mercado Pago on reactivation. The details are in Limitations.
The next charge date can’t be changed: the next cycle’s date is determined by Mercado Pago based on the plan’s frequency and can’t be brought forward or pushed back manually.
The frequency of an active subscription can’t be changed: if a subscriber wants to move from a monthly plan to a quarterly one, the only route is to cancel the current subscription and create a new one with the desired plan.
There are no backup cards: each subscription is tied to a single payment method. If the charge fails, no other method is attempted.
Every screen of the Reval admin has a WhatsApp button that opens a conversation with Reval’s AI agent, with your store’s domain pre-filled so it knows who is writing. It answers questions about setup, plans, charges and the portal, and escalates to the team when needed. Available on stores set to Spanish; it does not show on Portuguese stores yet.
Now that your store is set up to take subscriptions, explore the following sections to customize and optimize your operation:
Plan management
Create, edit and archive subscription plans. Learn how to configure frequencies and discounts and assign them to multiple products.
Advanced settings
Adjust the per-customer subscription limits, out-of-stock behavior, the thank-you page and more.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"REVAL","description":"Suscripciones recurrentes para Shopify cobradas con Mercado Pago.","colors":{"primary":"#052E29","light":"#E2F484","dark":"#052E29"},"logo":{"light":"https://mintcdn.com/reval/-FjSf_vLgdxHZM9w/logo/light.svg?fit=max\u0026auto=format\u0026n=-FjSf_vLgdxHZM9w\u0026q=85\u0026s=6771506618de746cc5a5358967565a95","dark":"https://mintcdn.com/reval/-FjSf_vLgdxHZM9w/logo/dark.svg?fit=max\u0026auto=format\u0026n=-FjSf_vLgdxHZM9w\u0026q=85\u0026s=e11704c0d7cc150b3001f0f894bb7420"},"favicon":"https://mintcdn.com/reval/-FjSf_vLgdxHZM9w/favicon/favicon.svg?fit=max\u0026auto=format\u0026n=-FjSf_vLgdxHZM9w\u0026q=85\u0026s=2deb3d7742e53da56632f4438fb6e1c2","background":{"color":{"light":"#F3F8F8","dark":"#0F1C1D"}},"seo":{"metatags":{"og:image":"https://docs.appreval.com/images/og.png","og:image:width":"1200","og:image:height":"630","twitter:image":"https://docs.appreval.com/images/og.png"}},"fonts":{"heading":{"family":"Archivo","weight":600},"body":{"family":"Geist","weight":400}},"styling":{"latex":true},"navigation":{"languages":[{"language":"es","default":true,"href":"introduccion/que-es-reval"},{"language":"en","href":"en/introduction/what-is-reval"},{"language":"pt","href":"pt/introducao/o-que-e-reval"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"reval","hasAudioNarration":false,"actualSubdomain":"reval","customDomains":["docs.appreval.com"],"gitSource":{"type":"github","owner":"latechfactory","repo":"reval-subscriptions","deployBranch":"master","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae379db724ecc4124ce3ce5","collectionId":"69ba0412-d413-498f-a112-819a9d0c6ff0","liveDeploymentHistoryId":"6ae379db724ecc4124ce3ce5","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae379db724ecc4124ce3ce5","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"es","tag":"Para tu negocio","count":15},{"language":"en","tag":"For your business","count":15},{"language":"pt","tag":"Para o seu negócio","count":15},{"language":"es","tag":"Para desarrolladores","count":5},{"language":"en","tag":"For developers","count":5},{"language":"pt","tag":"Para desenvolvedores","count":5},{"language":"es","tag":"Para tus clientes","count":4},{"language":"en","tag":"For your customers","count":4},{"language":"pt","tag":"Para os seus clientes","count":4},{"language":"es","tag":"Introducción","count":3},{"language":"en","tag":"Introduction","count":3},{"language":"pt","tag":"Introdução","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"jcbonina@latechfactory.com"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrodmgPn.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrMdmgPn.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFg08vz7ehw.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrgdmgPn.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrkdmgPn.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/geistmono/v6/or3nQ6H-1_WfwkMZI_qYFrcdmg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--reval-font-mono:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, monospace}code,kbd,pre,pre code,samp{font-family:var(--reval-font-mono)}h1{letter-spacing:-.025em;font-weight:600}h2,h3,h4,h5{letter-spacing:-.02em;font-weight:500}h3,h4,h5{letter-spacing:-.015em}h4,h5{letter-spacing:-.01em}h5{letter-spacing:-.005em}"}],"page":{"pagePath":"en/merchant/getting-started","slug":"/en/merchant/getting-started","pageMetadata":{"title":"Getting started with Reval: install and set up your store","description":"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.","sources":["app/routes/app.settings.tsx","app/routes/app._index.tsx","extensions/subscription-buybox/blocks/subscription-buybox.liquid","extensions/mi-suscripcion/src/MiSuscripcionPage.jsx","app/routes/app.plans.tsx","app/lib/mp/credentials.server.ts","extensions/subscription-buybox/blocks/subscription-cart.liquid"],"href":"/en/merchant/getting-started"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,Note,OptimizedImage,Step,Steps,Table,Tip,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Reval installs directly into your Shopify admin and requires no code changes or additional infrastructure. Follow this step-by-step guide to get your store ready to sell recurring subscriptions charged through Mercado Pago.`}),`\n`,_jsxs(_components.p,{children:[`The Reval dashboard walks you through it: while any setup is still missing you’ll see the `,_jsx(_components.strong,{children:`“Getting started”`}),` card with the real status of each item (credentials saved, webhook verified, first plan created and billing card added) and a direct link to this guide. Each item ticks itself as soon as you complete it, without reloading the page, and the card disappears on its own once everything is ready.`]}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`Reval requests the following permissions in your Shopify store at install time:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Read`}),`: orders, products, taxes, shipping rates and customer data.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Write`}),`: creating and updating recurring orders.`]}),`\n`]}),_jsx(_components.p,{children:`These permissions are strictly necessary to generate the automatic charges and to calculate shipping and taxes in real time during checkout.`})]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Install the app with your install link`,children:[_jsxs(_components.p,{children:[`Reval is a `,_jsx(_components.strong,{children:`custom distribution`}),` app: it isn’t published on the Shopify App Store. You’ll receive an install link generated specifically for your store.`]}),_jsxs(_components.p,{children:[`Open it with the store owner’s session and accept the permissions. Once installed, Reval appears under `,_jsx(_components.strong,{children:`Apps`}),` inside your admin, embedded — there’s no external site to log into.`]}),_jsx(Note,{children:_jsx(_components.p,{children:`The link is anchored to your store’s domain and only works for that store.`})})]}),_jsxs(Step,{title:`Enter your Mercado Pago credentials`,children:[_jsx(_components.p,{children:`Reval needs access to your Mercado Pago account to create the recurring charge mandates and to receive the notification for every charge.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`There is no OAuth connection`}),`: credentials are copied from the MP panel and pasted into Reval, where they’re stored encrypted for your store.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Everything that follows happens in the `,_jsx(_components.strong,{children:`Mercado Pago developer panel`}),`, inside your application. If you haven’t created it yet, step 2.0 guides you; if you already have it, skip straight to 2.1.`]})}),_jsxs(Warning,{children:[_jsx(_components.p,{children:_jsx(_components.strong,{children:`Create a new application dedicated to Reval. Don’t reuse the one you use to charge in your checkout.`})}),_jsx(_components.p,{children:`For two reasons:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Each application is created for one Mercado Pago product.`}),` A checkout application does not enable the Subscriptions APIs, which are the ones Reval needs for recurring charges.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Each application allows only one webhook URL per mode.`}),` If you paste Reval’s URL into an application that already has a webhook configured, you overwrite it — and your checkout’s notifications stop reaching where they were going, with no warning at all.`]}),`\n`]}),_jsxs(_components.p,{children:[`Having two applications `,_jsx(_components.strong,{children:`does not separate your money or your accounts`}),`: both belong to the same Mercado Pago account and everything is credited in the same place. An application is an integration credential, not a wallet. There’s no cost and no limit.`]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`If you sell with Mercado Pago but have `,_jsx(_components.strong,{children:`never been into the developer panel`}),`, you probably don’t have an application of your own: Shopify’s payments integration is linked from the store admin, without going through there. In that case, just create your first one.`]})}),_jsx(Heading,{level:`4`,id:`2-0-—-create-the-application-first-time-only`,children:`2.0 — Create the application (first time only)`}),_jsxs(_components.p,{children:[`Go to the `,_jsx(_components.a,{href:`https://www.mercadopago.com.ar/developers`,children:`Mercado Pago developer panel`}),` with the MP account that will charge the subscriptions. Use your own country’s domain (`,_jsx(_components.code,{children:`.com.br`}),`, `,_jsx(_components.code,{children:`.com.mx`}),`, `,_jsx(_components.code,{children:`.cl`}),`, and so on). At the top right, click `,_jsx(_components.strong,{children:`Integraciones`}),` (Integrations).`]}),_jsx(Note,{children:_jsx(_components.p,{children:`The Mercado Pago panel is shown in the language of your account’s country, so the labels below are given in Spanish — exactly as they appear in the screenshots — with the English meaning in parentheses.`})}),_jsx(Frame,{caption:`Open Integraciones in the developer panel`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-integraciones.webp?fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=a7456e2dd9ac3996519fa7d32bd24339`,alt:`Mercado Pago developer panel home. A red arrow points to the «Integraciones» button at the top right.`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`940`,height:`940`,\"data-path\":`images/mp-integraciones.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-integraciones.webp?w=280\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=a64a16e3baa03e17ab42cbe3de92fead 280w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-integraciones.webp?w=560\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=5c8cf6937351c1b6bbc720e73d1347a2 560w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-integraciones.webp?w=840\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=b0a01ba095f6aff1327414ec2365869a 840w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-integraciones.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=fe271b48602c3c82a0bdbefbac884640 1100w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-integraciones.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=80aee99c2bda4593108adce29cb9e9e1 1650w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-integraciones.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=676f570286b27bb82ad78213b5f70356 2500w`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Gestión de integraciones`}),` (integrations management), click `,_jsx(_components.strong,{children:`+ Crear aplicación`}),` (Create application).`]}),`\n`,_jsx(Frame,{caption:`Integrations management — Create application`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-gestion-integraciones.webp?fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=aba0374a865481093e1dd4390cab6316`,alt:`The «Gestión de integraciones» screen with the application list. A red box highlights the «+ Crear aplicación» button at the top right.`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`599`,height:`599`,\"data-path\":`images/mp-gestion-integraciones.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-gestion-integraciones.webp?w=280\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=8eb231a7aff1a307863f8c85381cb689 280w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-gestion-integraciones.webp?w=560\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=91933c71160e505f46d1dc5fa5614fcb 560w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-gestion-integraciones.webp?w=840\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=9414fb1b95db935025bab1dc6a6de49d 840w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-gestion-integraciones.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=a09064188e5be98a27ece41605320e28 1100w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-gestion-integraciones.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=44ab817fe12bed0df71ac52703fc592e 1650w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-gestion-integraciones.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=da72ad8750838bd7aeaf57dca20b2470 2500w`})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`Crear en el panel de integración`}),` (create in the integration panel), not «Crear con IA» (create with AI): it’s the option that creates the app and gives you access to the credentials.`]}),`\n`,_jsx(Frame,{caption:`Create in the integration panel`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-crear-en-panel.webp?fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=50d0a18f2c4fdedfbee77e247f1ec38c`,alt:`The «Creá una aplicación para empezar a integrar con Mercado Pago» screen with two options. A red box highlights «Crear en el panel de integración», below «Crear con IA».`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`741`,height:`741`,\"data-path\":`images/mp-crear-en-panel.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-crear-en-panel.webp?w=280\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=3225bad6f02f68e75d1d3094e17880e2 280w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-crear-en-panel.webp?w=560\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=07745bd1580fff5f9bd9a24dbbb82f37 560w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-crear-en-panel.webp?w=840\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=fc5801b115e3eea961811267bc26f91e 840w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-crear-en-panel.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=4a1ae9d250e57c1fffa749c2ff41bc6c 1100w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-crear-en-panel.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=e8fc7583b6b270449fe429e87614287b 1650w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-crear-en-panel.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=5a9628886515b7e84107dbf277258bb3 2500w`})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Elegí una solución para integrar`}),` (choose a solution to integrate), select `,_jsx(_components.strong,{children:`Suscripciones`}),` (Subscriptions — “Automatiza cobros recurrentes en tu sitio”).`]}),`\n`,_jsx(Frame,{caption:`Choose the Suscripciones solution`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-solucion-suscripciones.webp?fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=cfb95ae13b37220be98e1f2a5a99487b`,alt:`The «Elegí una solución para integrar» step with the options Checkout Pro, Checkout API, Suscripciones, Plataforma de e-commerce, QR Code and Mercado Pago Point. A red box highlights «Suscripciones».`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`787`,height:`787`,\"data-path\":`images/mp-solucion-suscripciones.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-solucion-suscripciones.webp?w=280\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=8302e43887fddc9e709d56de40d7de8d 280w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-solucion-suscripciones.webp?w=560\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=638b4ec36646464fc8cf8f6f1629f9f0 560w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-solucion-suscripciones.webp?w=840\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=a6b154704c7052c2724b6e804c1f6342 840w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-solucion-suscripciones.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=3c15b87647471cb0b799492688859d90 1100w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-solucion-suscripciones.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=41655f0ca1c05d2a16b5313d6438a359 1650w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-solucion-suscripciones.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=cffa73544608160eccfacdda9c570251 2500w`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This is the change from Mercado Pago’s previous flow: it used to be `,_jsx(_components.strong,{children:`Pagos online → Con un desarrollo propio → Checkout API`}),`. `,_jsx(_components.strong,{children:`Suscripciones`}),` is now a dedicated solution and the right one for Reval — it enables the recurring-charge APIs.`]})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Otros datos`}),` (other details), fill in the `,_jsx(_components.strong,{children:`Nombre de la aplicación`}),` (application name, e.g. “Reval - Suscripciones”), tick the personal data authorization and click `,_jsx(_components.strong,{children:`Crear aplicación`}),`.`]}),`\n`,_jsx(Frame,{caption:`Other details — name and authorization`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-otros-datos-nombre.webp?fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=87271dd81bce675595f3d719e7255262`,alt:`The «Otros datos» section of the «Crear aplicación» form, with the «Nombre de la aplicación» field filled in and the personal-data authorization checkbox ticked. The «Crear aplicación» button is below.`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`607`,height:`607`,\"data-path\":`images/mp-otros-datos-nombre.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-otros-datos-nombre.webp?w=280\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=dc7bd4f71d8a62cd8efc492347e50949 280w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-otros-datos-nombre.webp?w=560\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=d54a01c70b6f4dd122ece5b64bc5ed1f 560w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-otros-datos-nombre.webp?w=840\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=4b94806df0bcd198980dd815843986f2 840w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-otros-datos-nombre.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=e7ff8a187805a4567f93bf69893c92a2 1100w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-otros-datos-nombre.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=eec74ec85415130792a5355fc5890253 1650w, https://mintcdn.com/reval/Fu5iwh5vbTPdUPzy/images/mp-otros-datos-nombre.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=Fu5iwh5vbTPdUPzy\u0026q=85\u0026s=81e217ba8f1002eb70bd52f9bbeaea32 2500w`})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Open the newly created application from `,_jsx(_components.strong,{children:`Gestión de integraciones`}),` and, in the side menu, scroll down to `,_jsx(_components.strong,{children:`PRODUCCIÓN → Credenciales de producción`}),`. The first time, Mercado Pago asks you to `,_jsx(_components.strong,{children:`activate`}),` the credentials before showing them: pick the `,_jsx(_components.strong,{children:`Industria`}),` (industry) that best describes your business, enter your store’s `,_jsx(_components.strong,{children:`Sitio web`}),` (website, with `,_jsx(_components.code,{children:`https://`}),`), tick the personal-data authorization, solve the “No soy un robot” reCAPTCHA and click `,_jsx(_components.strong,{children:`Activar credenciales de producción`}),`.`]}),`\n`,_jsx(Frame,{caption:`Activating the production credentials`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/XPLwRWDxfmzRiiMc/images/mp-activar-credenciales-produccion.webp?fit=max\u0026auto=format\u0026n=XPLwRWDxfmzRiiMc\u0026q=85\u0026s=7bd6075ac5c27c21d1a4eb0a73aab170`,alt:`Mercado Pago's «Credenciales de producción» screen before activation. A form asks for Industria and Sitio web (required), below it a personal-data authorization checkbox, a «No soy un robot» reCAPTCHA and the «Activar credenciales de producción» button, still disabled.`,\"data-og-width\":`2000`,width:`2000`,\"data-og-height\":`838`,height:`838`,\"data-path\":`images/mp-activar-credenciales-produccion.webp`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/XPLwRWDxfmzRiiMc/images/mp-activar-credenciales-produccion.webp?w=280\u0026fit=max\u0026auto=format\u0026n=XPLwRWDxfmzRiiMc\u0026q=85\u0026s=7a1e0cde3bfeb708dce7e6e40c572c63 280w, https://mintcdn.com/reval/XPLwRWDxfmzRiiMc/images/mp-activar-credenciales-produccion.webp?w=560\u0026fit=max\u0026auto=format\u0026n=XPLwRWDxfmzRiiMc\u0026q=85\u0026s=db607cbb4f8a260786cf1c5c46a2d6eb 560w, https://mintcdn.com/reval/XPLwRWDxfmzRiiMc/images/mp-activar-credenciales-produccion.webp?w=840\u0026fit=max\u0026auto=format\u0026n=XPLwRWDxfmzRiiMc\u0026q=85\u0026s=9200593c6a83870f125efd795d0b12a3 840w, https://mintcdn.com/reval/XPLwRWDxfmzRiiMc/images/mp-activar-credenciales-produccion.webp?w=1100\u0026fit=max\u0026auto=format\u0026n=XPLwRWDxfmzRiiMc\u0026q=85\u0026s=1ad2eb1dfe38d4e5077415961e3de0d4 1100w, https://mintcdn.com/reval/XPLwRWDxfmzRiiMc/images/mp-activar-credenciales-produccion.webp?w=1650\u0026fit=max\u0026auto=format\u0026n=XPLwRWDxfmzRiiMc\u0026q=85\u0026s=f54cd50bda58bdfc51afe64d208b4af1 1650w, https://mintcdn.com/reval/XPLwRWDxfmzRiiMc/images/mp-activar-credenciales-produccion.webp?w=2500\u0026fit=max\u0026auto=format\u0026n=XPLwRWDxfmzRiiMc\u0026q=85\u0026s=de2f25cbc35e378997bac714bee647f1 2500w`})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Until you complete this step the screen shows neither the Public Key nor the Access Token.`})}),`\n`]}),`\n`]}),_jsx(_components.p,{children:`With the credentials activated, carry on with step 2.1.`}),_jsx(Heading,{level:`4`,id:`2-1-—-copy-the-production-credentials`,children:`2.1 — Copy the production credentials`}),_jsxs(_components.p,{children:[`In the side menu, scroll down to `,_jsx(_components.strong,{children:`PRODUCCIÓN → Credenciales de producción`}),` (Production → Production credentials).`]}),_jsx(Frame,{caption:`Production credentials in the Mercado Pago panel`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-credenciales-produccion.png?fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=94529eaa664861e679989688d0354dfc`,alt:`Mercado Pago production credentials screen. Red arrows point to three places: in the side menu, the «Credenciales de producción» option inside the PRODUCCIÓN section; and in the panel, the Public Key and Access Token fields, which are the two values to copy. Further down are Client ID and Client Secret, which aren't used.`,\"data-og-width\":`1715`,width:`1715`,\"data-og-height\":`987`,height:`987`,\"data-path\":`images/mp-credenciales-produccion.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-credenciales-produccion.png?w=280\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=58a879a5c48b753f5b927dcb908c763a 280w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-credenciales-produccion.png?w=560\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=f8e71845bb88bfb584b7d9ecc27b0e8b 560w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-credenciales-produccion.png?w=840\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=afc1a4b8710d71d11dd728ff2706eef1 840w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-credenciales-produccion.png?w=1100\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=bdc0d1ce2d53bd63eda2d773896af342 1100w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-credenciales-produccion.png?w=1650\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=f0e6ff3ce182c8c3acda38836e88b6b6 1650w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-credenciales-produccion.png?w=2500\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=a5587734c9179d562fd8924c0a90a107 2500w`})}),_jsxs(_components.p,{children:[`You need `,_jsx(_components.strong,{children:`two`}),` values from this screen:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`In Mercado Pago`}),_jsx(_components.th,{children:`Where it goes in Reval`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Public Key`}),` — starts with `,_jsx(_components.code,{children:`APP_USR`})]}),_jsx(_components.td,{children:`Public key`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Access Token`}),` — click the eye icon to reveal it`]}),_jsx(_components.td,{children:`Access token`})]})]})]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Client ID and Client Secret aren’t used.`}),` They’re on the same screen, right below, and it’s easy to copy them by mistake. Reval never asks for them.`]})}),_jsx(Heading,{level:`4`,id:`2-2-—-configure-the-webhook`,children:`2.2 — Configure the webhook`}),_jsxs(_components.p,{children:[`In the side menu, go to `,_jsx(_components.strong,{children:`NOTIFICACIONES → Webhooks`}),` (Notifications → Webhooks). Make sure you’re on the `,_jsx(_components.strong,{children:`Modo productivo`}),` (production mode) tab and not on “Modo de prueba” (test mode): they’re two independent configurations and the test one isn’t used.`]}),_jsx(Frame,{caption:`Webhook configuration in production mode`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-webhooks-modo-productivo.png?fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=700ba2fe34ccde2fa9957f1d6ab151e1`,alt:`Mercado Pago webhook configuration screen with the «Modo productivo» tab selected. Red arrows point to three places: in the side menu, the «Webhooks» option inside the NOTIFICACIONES section; and in the panel, the «URL de producción» field at the top and the «Clave secreta» field at the bottom. In between, the «Planes y suscripciones» and «Pagos (legacy)» events are ticked and the rest are not.`,\"data-og-width\":`1731`,width:`1731`,\"data-og-height\":`1018`,height:`1018`,\"data-path\":`images/mp-webhooks-modo-productivo.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-webhooks-modo-productivo.png?w=280\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=8c08f4ba0014861c4ade2b9937c69fbc 280w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-webhooks-modo-productivo.png?w=560\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=a654c9ffc13f41e74b379db821a16ed0 560w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-webhooks-modo-productivo.png?w=840\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=d55c593e91bcceebef0f0e647819b522 840w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-webhooks-modo-productivo.png?w=1100\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=afd362dd0dfc228543a91e49798b3d6a 1100w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-webhooks-modo-productivo.png?w=1650\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=a5016e8b924d504fdd9f376f57342ebe 1650w, https://mintcdn.com/reval/r9TrMUZi3HhtFQkw/images/mp-webhooks-modo-productivo.png?w=2500\u0026fit=max\u0026auto=format\u0026n=r9TrMUZi3HhtFQkw\u0026q=85\u0026s=0d4a7c2ab30e10355c873b0375c42190 2500w`})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`URL de producción`}),` (production URL), paste the `,_jsx(_components.strong,{children:`notifications URL (webhook)`}),` that Reval shows you in `,_jsx(_components.strong,{children:`Settings → Integrations — Mercado Pago`}),` (there’s a `,_jsx(_components.strong,{children:`Copy URL`}),` button next to it). The URL already comes built for your store — there’s no need to edit it.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`?shop=`}),` at the end is not optional: it’s what tells Reval which store the notification comes from and which secret key to validate it with. If you omit it, Mercado Pago still responds `,_jsx(_components.code,{children:`200`}),` and everything looks fine, but you’re relying on a fallback mechanism. Copy the full URL, exactly as Reval shows it.`]})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Eventos recomendados para integraciones con Suscripciones`}),` (events recommended for Subscriptions integrations), tick exactly two:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Planes y suscripciones`}),` (plans and subscriptions)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pagos (legacy)`}),` (payments, legacy)`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Don’t tick any others. Extra events don’t break anything, but they generate traffic that Reval discards.`}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Copy the `,_jsx(_components.strong,{children:`Clave secreta`}),` (secret key) shown at the very bottom. That’s the third value you’ll paste into Reval.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Guardar configuración`}),` (save configuration).`]}),`\n`]}),`\n`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The refresh button next to the secret key `,_jsx(_components.strong,{children:`generates a new one and invalidates the previous one`}),`. If you click it after having configured Reval, webhooks start failing signature validation and charges stop generating orders in Shopify. If that happens, copy the new key and update it in Reval.`]})}),_jsx(Note,{children:_jsx(_components.p,{children:`The name “Pagos (legacy)” sounds like something discontinued, but it’s the right event: it’s the one that notifies each individual charge on the mandate, and it’s the one Reval listens to in order to create the Shopify order.`})}),_jsx(Heading,{level:`4`,id:`2-3-—-paste-the-three-values-into-reval`,children:`2.3 — Paste the three values into Reval`}),_jsxs(_components.p,{children:[`In Reval, go to `,_jsx(_components.strong,{children:`Settings → Integrations — Mercado Pago`}),` and fill in:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Public key`}),` (starts with `,_jsx(_components.code,{children:`APP_USR`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Access token`}),` (starts with `,_jsx(_components.code,{children:`APP_USR`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Webhook secret`}),` — the secret key from the previous step`]}),`\n`]}),_jsx(_components.p,{children:`Save.`}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The access token and the webhook secret `,_jsx(_components.strong,{children:`aren’t shown again once saved`}),`: the fields stay masked. That’s the expected behavior. If you need to change them, type the new value over the top and save again.`]})}),_jsx(Heading,{level:`4`,id:`2-4-—-test-the-connection`,children:`2.4 — Test the connection`}),_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Test connection`}),`. The test uses the saved credentials, so `,_jsx(_components.strong,{children:`save before testing`}),`.`]}),_jsxs(_components.p,{children:[`If everything is fine, a green message appears with your Mercado Pago account name and your country code (`,_jsx(_components.code,{children:`MLA`}),` Argentina, `,_jsx(_components.code,{children:`MLB`}),` Brazil, `,_jsx(_components.code,{children:`MLC`}),` Chile, `,_jsx(_components.code,{children:`MCO`}),` Colombia, `,_jsx(_components.code,{children:`MLM`}),` Mexico, `,_jsx(_components.code,{children:`MPE`}),` Peru, `,_jsx(_components.code,{children:`MLU`}),` Uruguay).`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`What you see`}),_jsx(_components.th,{children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`”Connection OK — `,_jsx(_components.em,{children:`your account`}),` (MLA)“`]}),_jsx(_components.td,{children:`Done, move on to the next step.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`”Mercado Pago rejected the access token”`}),_jsxs(_components.td,{children:[`The token is incomplete or is a test one. Copy it again from `,_jsx(_components.strong,{children:`Credenciales de producción`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Connection OK but with `,_jsx(_components.strong,{children:`a different account name`})]}),_jsx(_components.td,{children:`Stop here. See the warning below.`})]})]})]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`If the name shown isn’t your account’s, the access token belongs to another account: `,_jsx(_components.strong,{children:`stop right there`}),`. A wrong token doesn’t throw an error, it would simply charge into the wrong account.`]}),_jsxs(_components.p,{children:[`Bear in mind as well that Reval operates with production credentials: `,_jsx(_components.strong,{children:`there is no sandbox mode`}),`, and MP’s test cards don’t work. To validate the flow, you make a real low-value purchase and refund it afterwards.`]})]}),_jsx(Heading,{level:`4`,id:`2-5-—-validate-the-notifications-webhook`,children:`2.5 — Validate the notifications (webhook)`}),_jsxs(_components.p,{children:[`The previous step tests your `,_jsx(_components.strong,{children:`credentials`}),`; this one confirms that Mercado Pago’s `,_jsx(_components.strong,{children:`notifications`}),` reach Reval and validate correctly. It’s what the Reval dashboard tracks as `,_jsx(_components.strong,{children:`“Webhook de Mercado Pago”`}),` on the “Primeros pasos” (Getting started) card: it stays pending until Reval receives a valid notification.`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the MP panel, go back to `,_jsx(_components.strong,{children:`NOTIFICACIONES → Webhooks → Modo productivo`}),` (where you set the URL in step 2.2).`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Simular notificación`}),` (Simulate notification) and send a test one (for example, of the `,_jsx(_components.strong,{children:`Pagos`}),` / Payments event). MP sends it to your URL, with the `,_jsx(_components.code,{children:`?shop=`}),` and signed with the secret key.`]}),`\n`,_jsxs(_components.li,{children:[`Back in the Reval dashboard, under `,_jsx(_components.strong,{children:`Primeros pasos`}),` (Getting started), the `,_jsx(_components.strong,{children:`“Webhook de Mercado Pago”`}),` item changes to `,_jsx(_components.strong,{children:`“último recibido: …”`}),` (last received) with the date. That’s it validated.`]}),`\n`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`Save the three values in Reval first (step 2.3): the notification validation uses the saved `,_jsx(_components.strong,{children:`secret key`}),`. If you simulate before saving it, the signature won’t validate and the step won’t tick.`]})})]}),_jsxs(Step,{title:`Create your first subscription plan`,children:[_jsx(_components.p,{children:`Plans define the charge frequency and the discount subscribers get relative to the list price.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Head to `,_jsx(_components.strong,{children:`Plans`}),` in Reval’s side menu and fill in the `,_jsx(_components.strong,{children:`Create a subscription plan`}),` section.`]}),`\n`,_jsxs(_components.li,{children:[`Complete the fields:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Plan name`}),`: for example, “Monthly” or “Quarterly with discount”.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Frequency`}),`: combine a numeric interval with a time unit — `,_jsx(_components.strong,{children:`days`}),`, `,_jsx(_components.strong,{children:`weeks`}),` or `,_jsx(_components.strong,{children:`months`}),`. For example: 1 month for monthly billing, 3 months for quarterly, 14 days for fortnightly.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Discount type`}),`: `,_jsx(_components.em,{children:`percentage discount`}),` (between 1 and 99, off each product’s list price) or `,_jsx(_components.em,{children:`fixed price`}),` (the same amount for every product in the plan). If you don’t want to apply a discount, use fixed price with the product’s normal price.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Extra discount on 1st order`}),` (optional): a percentage that applies ONLY to the first charge, calculated on the list price. It `,_jsx(_components.strong,{children:`replaces`}),` the plan’s discount on that first order — it doesn’t add to it. From the second cycle onward the plan’s normal price is charged, and the buyer sees both prices before subscribing. More detail in `,_jsx(_components.a,{href:`/en/merchant/plans#first-order-discount`,children:`Plans`}),`.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`Select the products and click `,_jsx(_components.strong,{children:`Create plan`}),`.`]}),`\n`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Mercado Pago has a `,_jsx(_components.strong,{children:`minimum amount per charge`}),` (it depends on your account’s currency). Reval won’t let you save plans whose final price falls below that minimum, and it shows you the exact value when you try — if you see that notice, raise the price or lower the discount.`]})}),_jsx(_components.p,{children:`You can create as many plans as you need. Buyers will see them as options in the product’s buy box.`})]}),_jsxs(Step,{title:`Add the Reval block to your theme`,children:[_jsxs(_components.p,{children:[`The buy box is the widget that appears on the product page and lets the buyer choose between a one-time purchase and subscribing. You add it as an `,_jsx(_components.strong,{children:`app block`}),` from the theme editor — no code required:`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In Shopify: `,_jsx(_components.strong,{children:`Online Store → Themes → Customize`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Open a `,_jsx(_components.strong,{children:`product page`}),` and, in the product information section, click `,_jsx(_components.strong,{children:`Add block → Apps → “Reval”`}),`.`]}),`\n`,_jsx(_components.li,{children:`Save. The block positions itself next to the purchase buttons (quantity → options → subscribe button), wherever you leave it.`}),`\n`]}),_jsxs(_components.p,{children:[`From the block’s settings you can edit the `,_jsx(_components.strong,{children:`benefits`}),` shown when the subscription is selected and turn on `,_jsx(_components.strong,{children:`pre-selection`}),` of the subscribe option. The `,_jsx(_components.strong,{children:`“Mostrar opción de compra única”`}),` setting (show the one-time purchase option, on by default) controls whether the buy box offers buying without a subscription: turn it off to sell the product `,_jsx(_components.strong,{children:`by subscription only`}),`. With `,_jsx(_components.strong,{children:`“Orden de las opciones”`}),` (option order) you choose which option renders first — “Compra única primero” (one-time first, as shipped) or “Suscripción primero” (subscription first), for brands that sell mainly by subscription; the order doesn’t change which option starts selected, that remains the pre-selection setting’s job. The checkout’s `,_jsx(_components.strong,{children:`logo, accent colour and favicon`}),` are set centrally in Reval’s `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/en/merchant/settings`,children:`Marca`})}),` (Brand) module.`]}),_jsxs(_components.p,{children:[`The block also has `,_jsx(_components.strong,{children:`style`}),` settings so it matches your theme’s buttons and cards: `,_jsx(_components.strong,{children:`Tipografía`}),` (typography: a custom font for the whole block, button included), `,_jsx(_components.strong,{children:`Botón «Suscribirme»`}),` (the subscribe button: colour, text colour, corner radius and font size; on box pages it applies to the “Armá tu caja” button) and `,_jsx(_components.strong,{children:`Tarjetas de opción`}),` (option cards: border colour and thickness, card background and radius, border and background of the selected card, colour of the selection circle, discount badge colours and the colour of the “Ahorrás $…” savings line). A single `,_jsx(_components.strong,{children:`«Tamaño del texto»`}),` (text size) control, 70 to 150 % with 100 as shipped, grows or shrinks every text in the block at once while keeping the proportions, for themes with large or small type. Anything you leave empty or at 0 takes the theme’s value, so there’s nothing to touch to get started. If you also use the subscription cart and style the button from there, the block’s setting wins.`]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Browser tab icon:`}),` set it in Reval’s `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/en/merchant/settings`,children:`Marca`})}),` (Brand) module (Favicon field). If you leave it empty, Reval uses the checkout logo, and as a last resort your store’s `,_jsx(_components.strong,{children:`square logo`}),` in Shopify (`,_jsx(_components.strong,{children:`Settings → Brand → Square logo`}),`, a separate setting from the theme’s favicon); if that isn’t uploaded either, Reval adapts your main logo into a square.`]})}),_jsxs(_components.p,{children:[`The buy box only appears on products that have an `,_jsx(_components.strong,{children:`active plan`}),` — on the rest the block is invisible, so it’s safe to add it to the general product template.`]}),_jsx(Frame,{caption:`Buy box preview with the subscription option active`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/reval/xIYE_GetXZ6D8oUR/images/buy-box-customizer-preview.png?fit=max\u0026auto=format\u0026n=xIYE_GetXZ6D8oUR\u0026q=85\u0026s=20b229f984d144ea1e2f382dea63d403`,alt:`Buy box showing One-time purchase and Subscribe and save with 20% OFF`,width:`559`,height:`326`,\"data-og-width\":`559`,\"data-og-height\":`326`,\"data-path\":`images/buy-box-customizer-preview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/reval/xIYE_GetXZ6D8oUR/images/buy-box-customizer-preview.png?w=280\u0026fit=max\u0026auto=format\u0026n=xIYE_GetXZ6D8oUR\u0026q=85\u0026s=50d36823ef296c1bf2d31d59a84bf94a 280w, https://mintcdn.com/reval/xIYE_GetXZ6D8oUR/images/buy-box-customizer-preview.png?w=560\u0026fit=max\u0026auto=format\u0026n=xIYE_GetXZ6D8oUR\u0026q=85\u0026s=7d3bbcbab2a18c881b31ddea2ac4cd32 560w, https://mintcdn.com/reval/xIYE_GetXZ6D8oUR/images/buy-box-customizer-preview.png?w=840\u0026fit=max\u0026auto=format\u0026n=xIYE_GetXZ6D8oUR\u0026q=85\u0026s=e46dc553e543dfb53b1a241126ceea02 840w, https://mintcdn.com/reval/xIYE_GetXZ6D8oUR/images/buy-box-customizer-preview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=xIYE_GetXZ6D8oUR\u0026q=85\u0026s=d63126d9561c86841d40816dd14a4d46 1100w, https://mintcdn.com/reval/xIYE_GetXZ6D8oUR/images/buy-box-customizer-preview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=xIYE_GetXZ6D8oUR\u0026q=85\u0026s=b23733b8713002c1bdac452bc2c81f04 1650w, https://mintcdn.com/reval/xIYE_GetXZ6D8oUR/images/buy-box-customizer-preview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=xIYE_GetXZ6D8oUR\u0026q=85\u0026s=6a829c9733d9c249cec2f0b276f2d2c0 2500w`})}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Want to sell subscriptions from a landing page?`}),` Reval ships a second block, `,_jsx(_components.strong,{children:`“Reval · Sección de suscripción”`}),`, for any page that is not a product page — a landing, the home page, a “Subscribe” page. The buyer picks the product, the variant, the quantity and the frequency, and subscribes right there:`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the theme editor open the page (for example `,_jsx(_components.strong,{children:`Pages → your landing`}),`) and add an `,_jsx(_components.strong,{children:`Apps`}),` section (or any section that accepts app blocks).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Add block → Apps → “Reval · Sección de suscripción”`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`In the block settings pick the `,_jsx(_components.strong,{children:`products`}),` (up to 12). With two or more, the buyer sees one card per product; if the product has variants, they show up as buttons to choose from.`]}),`\n`,_jsxs(_components.li,{children:[`Optional: `,_jsx(_components.strong,{children:`short names`}),` for the cards (one per line, in the order of the list — “Orange” instead of “Electrolytes Orange x30”), a heading for the product list, a heading, an intro text, benefits and the button label.`]}),`\n`,_jsxs(_components.li,{children:[`Optional, for the product image:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Show the product image`}),`: turns the image next to the cards on or off.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Pin the image while scrolling`}),`: on wide screens, the image and the cards follow the scroll while the right-hand column is read. It has no effect on phones.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Image fit`}),`: `,_jsx(_components.strong,{children:`Crop to fill the frame`}),` (may cut the edges) or `,_jsx(_components.strong,{children:`Show in full (no cropping)`}),`, with space around it if needed.`]}),`\n`]}),`\n`]}),`\n`]}),_jsx(_components.p,{children:`On phones, the product cards form a row that slides sideways. If the buyer switches product, the option they had already chosen (for example, the size) is kept when the new product has it in stock; otherwise, the new product’s own option is used.`}),_jsxs(_components.p,{children:[`This block is `,_jsx(_components.strong,{children:`subscription-only`}),` (no one-time purchase) and is not offered on product pages — use the “Reval” block there. If a product in the list has no active plan, the button is disabled with a notice: assign it a plan in `,_jsx(_components.strong,{children:`Plans`}),` or remove it from the list. If you pick a Reval box, the button leads to the box builder.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Want buyers to add several subscriptions and pay for them together?`}),` Turn on the `,_jsx(_components.strong,{children:`subscription cart`}),`, an app embed that ships turned off:`]}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In the theme editor open `,_jsx(_components.strong,{children:`App embeds`}),` in the sidebar.`]}),`\n`,_jsxs(_components.li,{children:[`Turn on `,_jsx(_components.strong,{children:`“Reval · Carrito de suscripciones”`}),` and save.`]}),`\n`]}),_jsxs(_components.p,{children:[`With the cart on, the “Reval” block’s button reads `,_jsx(_components.strong,{children:`«Agregar al carrito»`}),` (add to cart): the product goes into a dedicated subscription cart, which opens as a side panel, instead of going straight to the checkout. There the buyer sees each product with its delivery frequency, the subscription savings and the first-order price, and pays for everything with `,_jsx(_components.strong,{children:`«Continuar al pago»`}),` (continue to payment), entering the card only once.`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Before adding a product, Reval checks that it can be subscribed to (an active plan at that frequency, stock and the `,_jsx(_components.a,{href:`/en/merchant/settings#orders-and-inventory`,children:`maximum new subscriptions per day`}),`). If it can’t, it shows the same notice as the checkout.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Each frequency is one subscription.`}),` Mercado Pago charges each subscription at a single frequency, so a cart with monthly and bi-monthly products creates two subscriptions. The buyer pays only once when subscribing, but from then on sees one debit per frequency. The cart says so before payment.`]}),`\n`,_jsxs(_components.li,{children:[`The subscription cart is `,_jsx(_components.strong,{children:`separate from the store’s cart`}),`: one-time purchases are still paid in the Shopify checkout. The cart explains this above the products and notes at the bottom that store coupons apply to one-time purchases only.`]}),`\n`,_jsx(_components.li,{children:`Products are saved in the buyer’s browser until they pay or remove them.`}),`\n`]}),_jsx(_components.p,{children:`In the embed’s settings you can choose:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Floating button`}),`: shown on every page when the cart has products, bottom right or bottom left.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Typography`}),`: by default the cart uses the theme’s. You can pick a custom font and font size for the whole cart.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Style`}),`: button colour and button text colour, cart background, text colour and button corner radius. Empty or 0 = the theme’s value. Fill them in only if you want to force another one.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Buttons individually`}),`: “Agregar al carrito” (the one that replaces the block’s “Suscribirme” while the cart is on), “Continuar al pago” and the floating button each have their own colour, text colour, corner radius and font size, which override the Style group. If you also styled the button from the “Reval” block on the product page, the block’s setting wins.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Texts`}),`: the cart title, the separate-carts notice and the coupon note. Empty = default text.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Notice in the store’s cart`}),`: adds a message to the theme’s cart explaining that subscriptions are paid separately, with a `,_jsx(_components.strong,{children:`«Ver mis suscripciones»`}),` (see my subscriptions) link. It depends on the theme: if it doesn’t show up or lands somewhere odd, turn it off.`]}),`\n`]}),_jsx(_components.p,{children:`With the embed off everything works as before: the button goes straight to the checkout. The “Reval · Sección de suscripción” block on landing pages always goes straight to the checkout.`}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The buy box requires your store’s theme to have `,_jsx(_components.strong,{children:`JavaScript enabled`}),`. If you use a heavily customized theme or one with blocked scripts, check that the widget loads correctly before publishing it.`]})})]}),_jsxs(Step,{title:`Add the portal link to the customer account`,children:[_jsxs(_components.p,{children:[`Reval includes a block for Shopify’s `,_jsx(_components.strong,{children:`customer accounts`}),` that gives every subscriber a direct link to the portal from their account — where they can pause, swap products, update their address, review orders and cancel. The block ships with the app; you just add it in your customer account editor.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`It works with Shopify’s `,_jsx(_components.strong,{children:`new customer accounts`}),`, not the classic accounts.`]})}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`In Shopify: `,_jsx(_components.strong,{children:`Settings → Customer accounts`}),` and open the customization editor for the account pages (`,_jsx(_components.strong,{children:`Customize`}),` button).`]}),`\n`,_jsxs(_components.li,{children:[`Go to the `,_jsx(_components.strong,{children:`Profile`}),` page and click `,_jsx(_components.strong,{children:`Add block → Apps → “Mi Suscripción”`}),` (the Reval subscription block).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Save`}),`.`]}),`\n`]}),_jsxs(_components.p,{children:[`The subscriber now sees a `,_jsx(_components.strong,{children:`“Mi Suscripción”`}),` item in their account navigation; opening it shows a link that takes them straight to the portal, already signed in through their session — no extra details needed. The heading and link text follow the language you picked in `,_jsx(_components.a,{href:`/en/merchant/settings#language`,children:`Settings → Language`}),`.`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`If `,_jsx(_components.strong,{children:`“Mi Suscripción” doesn’t appear`}),` in the list of app blocks, the extension hasn’t been deployed to your store yet. Ask your Reval contact to publish it — it’s distributed with the app, not installed separately.`]})})]}),_jsxs(Step,{title:`Run a test subscription`,children:[_jsx(_components.p,{children:`Before announcing the feature to your customers, verify that the full flow works end to end.`}),_jsxs(_components.p,{children:[`Since Reval operates with production credentials, the test is done with a `,_jsx(_components.strong,{children:`real card and a small amount`}),`, which you refund afterwards. It’s worth creating a cheap temporary plan for this.`]}),_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Open the product page where the buy box appears in an incognito window.`}),`\n`,_jsx(_components.li,{children:`Choose the test plan and complete the checkout with a real card.`}),`\n`,_jsxs(_components.li,{children:[`Verify that:`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The order appears under `,_jsx(_components.strong,{children:`Orders`}),` in the Shopify admin, with the `,_jsx(_components.code,{children:`Subscription`}),`, `,_jsx(_components.code,{children:`First purchase`}),` and `,_jsx(_components.code,{children:`Cycle 1`}),` tags.`]}),`\n`,_jsxs(_components.li,{children:[`The subscription appears under `,_jsx(_components.strong,{children:`Subscriptions`}),` in Reval, in active status.`]}),`\n`,_jsx(_components.li,{children:`The mandate shows up in your Mercado Pago panel.`}),`\n`]}),`\n`]}),`\n`,_jsx(_components.li,{children:`Cancel the test subscription and refund the charge from the MP panel.`}),`\n`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`If you also offer add-ons, tick one in the test checkout: verify that `,_jsx(_components.strong,{children:`two separate charges`}),` appear in Mercado Pago (the mandate’s and the add-on’s) and that the order includes both lines.`]})})]}),_jsxs(Step,{title:`Add the billing card`,children:[_jsxs(_components.p,{children:[`Until you add the card Reval is paid with, your store is in `,_jsx(_components.strong,{children:`setup mode`}),`: the admin works normally, but the store only accepts a few test subscriptions — just enough for the purchase in the previous step. The dashboard shows you how many you’ve used.`]}),_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Billing → Payment method`}),`, click `,_jsx(_components.strong,{children:`Add card`}),` and save it. With that, the store moves to production and accepts subscriptions with no limit. What’s charged and how is covered in `,_jsx(_components.a,{href:`/en/merchant/billing`,children:`Billing`}),`.`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`known-limitations`,children:`Known limitations`}),`\n`,_jsx(_components.p,{children:`Before launching your subscription program, keep the following current Reval restrictions in mind:`}),`\n`,_jsx(Warning,{children:_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`There is no on-demand charging`}),`: you can’t start a manual charge outside the scheduled cycle. Charges are executed automatically by Mercado Pago on the scheduled date.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Skipping a cycle exists, but with an approximate date`}),`: it’s enabled from Settings → Orders and inventory, and under the hood it works by pausing the debit and reactivating it one cycle later, so the date of the following charge is decided by Mercado Pago on reactivation. The details are in `,_jsx(_components.a,{href:`/en/introduction/limitations`,children:`Limitations`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The next charge date can’t be changed`}),`: the next cycle’s date is determined by Mercado Pago based on the plan’s frequency and can’t be brought forward or pushed back manually.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The frequency of an active subscription can’t be changed`}),`: if a subscriber wants to move from a monthly plan to a quarterly one, the only route is to cancel the current subscription and create a new one with the desired plan.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`There are no backup cards`}),`: each subscription is tied to a single payment method. If the charge fails, no other method is attempted.`]}),`\n`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`need-help`,children:`Need help?`}),`\n`,_jsxs(_components.p,{children:[`Every screen of the Reval admin has a `,_jsx(_components.strong,{children:`WhatsApp button`}),` that opens a conversation with Reval’s AI agent, with your store’s domain pre-filled so it knows who is writing. It answers questions about setup, plans, charges and the portal, and escalates to the team when needed. Available on stores set to Spanish; it does not show on Portuguese stores yet.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`next-steps`,children:`Next steps`}),`\n`,_jsx(_components.p,{children:`Now that your store is set up to take subscriptions, explore the following sections to customize and optimize your operation:`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Plan management`,icon:`repeat`,href:`/en/merchant/plans`,children:_jsx(_components.p,{children:`Create, edit and archive subscription plans. Learn how to configure frequencies and discounts and assign them to multiple products.`})}),_jsx(Card,{title:`Advanced settings`,icon:`sliders`,href:`/en/merchant/settings`,children:_jsx(_components.p,{children:`Adjust the per-customer subscription limits, out-of-stock behavior, the thank-you page and more.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Getting started with Reval: install and set up your store","description":"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.","sources":["app/routes/app.settings.tsx","app/routes/app._index.tsx","extensions/subscription-buybox/blocks/subscription-buybox.liquid","extensions/mi-suscripcion/src/MiSuscripcionPage.jsx","app/routes/app.plans.tsx","app/lib/mp/credentials.server.ts","extensions/subscription-buybox/blocks/subscription-cart.liquid"],"href":"/en/merchant/getting-started"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"2.0 — Create the application (first time only)","slug":"2-0-—-create-the-application-first-time-only","depth":4,"children":[]},{"title":"2.1 — Copy the production credentials","slug":"2-1-—-copy-the-production-credentials","depth":4,"children":[]},{"title":"2.2 — Configure the webhook","slug":"2-2-—-configure-the-webhook","depth":4,"children":[]},{"title":"2.3 — Paste the three values into Reval","slug":"2-3-—-paste-the-three-values-into-reval","depth":4,"children":[]},{"title":"2.4 — Test the connection","slug":"2-4-—-test-the-connection","depth":4,"children":[]},{"title":"2.5 — Validate the notifications (webhook)","slug":"2-5-—-validate-the-notifications-webhook","depth":4,"children":[]},{"title":"Known limitations","slug":"known-limitations","depth":2,"children":[]},{"title":"Need help?","slug":"need-help","depth":2,"children":[]},{"title":"Next steps","slug":"next-steps","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"reval","siteName":"REVAL","title":"Getting started with Reval: install and set up your store - REVAL","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"es":{"href":"/introduccion/que-es-reval","matchLevel":3},"en":{"href":"/en/merchant/getting-started","matchLevel":0},"pt":{"href":"/pt/introducao/o-que-e-reval","matchLevel":3}}},"lastModified":"2026-10-29T16:14:40.829Z","originalFileLocation":"en/merchant/getting-started.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.\">\u003cmeta data-mint-head name=\"application-name\" content=\"REVAL\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Getting started with Reval: install and set up your store - REVAL\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"REVAL\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.appreval.com/en/merchant/getting-started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.appreval.com/images/og.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Getting started with Reval: install and set up your store - REVAL\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.appreval.com/images/og.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/reval/u8wEYfRpAyQidlZA/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"REVAL\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#052E29\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.appreval.com/en/merchant/getting-started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/merchant/getting-started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.appreval.com/#organization\",\"name\":\"REVAL\",\"url\":\"https://docs.appreval.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/reval/-FjSf_vLgdxHZM9w/logo/light.svg?fit=max\u0026auto=format\u0026n=-FjSf_vLgdxHZM9w\u0026q=85\u0026s=6771506618de746cc5a5358967565a95\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.appreval.com#website\",\"name\":\"REVAL\",\"url\":\"https://docs.appreval.com\",\"publisher\":{\"@id\":\"https://docs.appreval.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.appreval.com/en/merchant/getting-started#webpage\",\"url\":\"https://docs.appreval.com/en/merchant/getting-started\",\"name\":\"Getting started with Reval: install and set up your store\",\"description\":\"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.\",\"dateModified\":\"2026-10-29T16:14:40.829Z\",\"isPartOf\":{\"@id\":\"https://docs.appreval.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.appreval.com/en/merchant/getting-started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.appreval.com/en/merchant/getting-started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REVAL\",\"item\":\"https://docs.appreval.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Getting started with Reval: install and set up your store\",\"item\":\"https://docs.appreval.com/en/merchant/getting-started\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.appreval.com/en/merchant/getting-started#article\",\"headline\":\"Getting started with Reval: install and set up your store\",\"name\":\"Getting started with Reval: install and set up your store\",\"description\":\"Install Reval in your Shopify store, connect Mercado Pago and create your first recurring subscription plan in under 15 minutes.\",\"url\":\"https://docs.appreval.com/en/merchant/getting-started\",\"mainEntityOfPage\":{\"@id\":\"https://docs.appreval.com/en/merchant/getting-started#webpage\"},\"image\":\"https://docs.appreval.com/images/og.png\",\"dateModified\":\"2026-10-29T16:14:40.829Z\",\"publisher\":{\"@id\":\"https://docs.appreval.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.appreval.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"REVAL\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"REVAL","nav":{"global":null,"languages":[{"language":"es","default":true,"pages":[{"title":"es","href":"/introduccion/que-es-reval"}]},{"language":"en","groups":[{"group":"Introduction","pages":[{"title":"What Reval is: subscriptions for Latin American merchants","href":"/en/introduction/what-is-reval"},{"title":"How Reval works: from the chosen plan to the Shopify order","href":"/en/introduction/how-it-works"},{"title":"Reval's limitations: what you can't do, and why","description":"Reval's design decisions explained transparently: what isn't possible today, the real reason behind it and what alternative you have available.","href":"/en/introduction/limitations"}]},{"group":"For your business","pages":[{"title":"Getting started with Reval: install and set up your store","href":"/en/merchant/getting-started"},{"title":"Subscription plans: frequency, price and activation","description":"How to create plan groups, tie them to variants, choose between a percentage discount and a fixed price, and apply a price change to existing subscribers.","href":"/en/merchant/plans"},{"title":"Products: one-time upsell, swap/add and preselected plan","href":"/en/merchant/products"},{"title":"Boxes: customer-built bundles","href":"/en/merchant/boxes"},{"title":"Full Reval configuration in your Shopify store","href":"/en/merchant/settings"},{"title":"Billing: what Reval charges you and how","href":"/en/merchant/billing"},{"title":"Analytics with Google Tag Manager","href":"/en/merchant/analytics"},{"title":"Showing the subscription in the order confirmation email","href":"/en/merchant/order-email"},{"title":"Managing active, paused and cancelled subscriptions","href":"/en/merchant/subscriptions"},{"title":"Customers: your subscribers grouped with their monthly value","href":"/en/merchant/customers"},{"title":"Orders: all of your store's orders, with each one's type","href":"/en/merchant/orders"},{"title":"Abandoned checkouts","href":"/en/merchant/abandoned-checkouts"},{"title":"Surprises: gifts and cycle-based discounts to retain subscribers","href":"/en/merchant/surprises"},{"title":"Subscription metrics and KPI dashboard in Reval","href":"/en/merchant/dashboard"},{"title":"Tools: exporting data and bulk operations","href":"/en/merchant/bulk-operations"}]},{"group":"For your customers","pages":[{"title":"Your subscription portal: get in and manage your plan","href":"/en/subscriber/portal-overview"},{"title":"How to manage your subscription: pause, change and more","href":"/en/subscriber/manage-subscription"},{"title":"Add-ons: add extra products to your next shipment cycle","href":"/en/subscriber/add-ons"},{"title":"Frequently asked questions about your Reval subscription","href":"/en/subscriber/faq"}]},{"group":"For developers","pages":[{"title":"Reval API: query your subscriptions from your own tools","href":"/en/developers/api"},{"title":"API schema reference","href":"/en/developers/api-reference"},{"title":"Reval webhooks: receive subscription events on your server","href":"/en/developers/webhooks"},{"title":"Recipes: typical integrations with the API and webhooks","href":"/en/developers/recipes"},{"title":"Connect Claude and ChatGPT to your store (MCP)","href":"/en/developers/mcp"}]}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/introducao/o-que-e-reval"}]}]},"basePath":"","title":"Getting started with Reval: install and set up your store - REVAL","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DXXFP6nH.js","DynamicMarkdown-B54_zNBF.js","zoom-image-lightbox-BG6oD64b.js","lightbox-handle-r17bVUz3.js"]}
