- Leitura: pedidos, produtos, impostos, valores de frete e dados de clientes.
- Escrita: criação e atualização de pedidos recorrentes.
Instale o app com o seu link de instalação
Informe as suas credenciais do Mercado Pago
2.0 — Crie a aplicação (só na primeira vez)
Acesse o painel de desenvolvedores do Mercado Pago com a conta do MP que vai cobrar as assinaturas. No canto superior direito, clique em Integrações (Integraciones).
Abra Integrações no painel de desenvolvedores
-
Em Gestão de integrações (Gestión de integraciones), clique em + Criar aplicação (Crear aplicación).

Gestão de integrações — Criar aplicação
-
Escolha Criar no painel de integração (Crear en el panel de integración), não «Criar com IA» (Crear con IA): é a opção que cria a aplicação e dá acesso às credenciais.

Criar no painel de integração
-
Em Escolha uma solução para integrar (Elegí una solución para integrar), selecione Assinaturas (Suscripciones — “Automatiza cobros recurrentes en tu sitio”).

Escolha a solução Assinaturas
Esta é a mudança em relação ao fluxo anterior do Mercado Pago: antes era preciso escolher Pagos online → Con un desarrollo propio → Checkout API. Agora Assinaturas é uma solução dedicada e é a correta para a Reval — é a que habilita as APIs de cobrança recorrente. -
Abra Outros dados (Otros datos), preencha o Nome da aplicação (Nombre de la aplicación — por exemplo, “Reval - Suscripciones”), marque a autorização de dados pessoais e clique em Criar aplicação.

Outros dados — nome e autorização
-
Entre na aplicação recém-criada por Gestão de integrações e, no menu lateral, desça até PRODUÇÃO → Credenciais de produção (PRODUCCIÓN → Credenciales de producción). Na primeira vez, o Mercado Pago pede para ativar as credenciais antes de mostrá-las: escolha a Indústria que melhor descreve o seu negócio, informe o Site da sua loja (com
https://), marque a autorização de dados pessoais, resolva o «Não sou um robô» e clique em Ativar credenciais de produção.
Ativar as credenciais de produção
Enquanto você não concluir este passo, a tela não mostra a Public Key nem o Access Token.
2.1 — Copie as credenciais de produção
No menu lateral, desça até PRODUÇÃO → Credenciais de produção (PRODUCCIÓN → Credenciales de producción).
Credenciais de produção no painel do Mercado Pago
2.2 — Configure o webhook
No menu lateral, entre em NOTIFICAÇÕES → Webhooks (NOTIFICACIONES → Webhooks). Confirme que você está na aba Modo produtivo e não em “Modo de teste”: são duas configurações independentes e a de teste não é usada.
Configuração de webhooks em modo produtivo
- Em URL de produção, cole a URL de notificações (webhook) que a Reval mostra em Configuração → Integrações — Mercado Pago (há um botão Copiar URL ao lado). A URL já vem montada com a sua loja — não é preciso editá-la.
-
Em Eventos recomendados para integrações com Assinaturas, marque exatamente dois:
- Planos e assinaturas (Planes y suscripciones)
- Pagamentos (legacy) (Pagos (legacy))
- Copie a Chave secreta que aparece no final da tela. Esse é o terceiro valor que você vai colar na Reval.
- Clique em Salvar configuração.
2.3 — Cole os três valores na Reval
Na Reval, vá em Configuração → Integrações — Mercado Pago e preencha:- Public key (começa com
APP_USR) - Access token (começa com
APP_USR) - Webhook secret — a chave secreta do passo anterior
2.4 — Teste a conexão
Clique em Testar conexão. O teste usa as credenciais salvas, então salve antes de testar.Se tudo estiver certo, aparece uma mensagem verde com o nome da sua conta do Mercado Pago e o código do seu país (MLA Argentina, MLB Brasil, MLC Chile, MCO Colômbia, MLM México, MPE Peru, MLU Uruguai).2.5 — Valide as notificações (webhook)
O passo anterior testa as credenciais; este confirma que as notificações do Mercado Pago chegam à Reval e validam corretamente. É o que o dashboard da Reval marca como «Webhook do Mercado Pago» no cartão «Primeiros passos»: fica pendente até a Reval receber uma notificação válida.- No painel do MP, volte a NOTIFICACIONES → Webhooks → Modo productivo (onde você configurou a URL no passo 2.2).
- Clique em Simular notificación (Simular notificação) e envie uma de teste (por exemplo, do evento Pagos / Pagamentos). O MP a envia para a sua URL, com o
?shop=e assinada com a chave secreta. - De volta ao dashboard da Reval, em Primeiros passos, o item «Webhook do Mercado Pago» muda para «último recebido: …» com a data. Assim fica validado.
Crie o seu primeiro plano de assinatura
- Vá em Planos no menu lateral da Reval e preencha a seção Criar um plano de assinatura.
- Preencha os campos:
- Nome do plano: por exemplo, “Mensal” ou “Trimestral com desconto”.
- Frequência: combine um intervalo numérico com uma unidade de tempo — dias, semanas ou meses. Por exemplo: 1 mês para cobrança mensal, 3 meses para trimestral, 14 dias para quinzenal.
- Tipo de desconto: percentual de desconto (entre 1 e 99, sobre o preço de tabela de cada produto) ou preço fixo (o mesmo valor para todos os produtos do plano). Se você não quiser aplicar desconto, use preço fixo com o preço normal do produto.
- Desconto extra 1º pedido (opcional): um percentual que se aplica SOMENTE à primeira cobrança, calculado sobre o preço de tabela. Ele substitui o desconto do plano nesse primeiro pedido, não se soma. A partir do segundo ciclo é cobrado o preço normal do plano, e o comprador vê os dois preços antes de assinar. Mais detalhes em Planos.
- Selecione os produtos e clique em Criar plano.
Adicione o bloco da Reval ao seu tema
- Na Shopify: Loja virtual → Temas → Personalizar.
- Abra uma página de produto e, na seção de informações do produto, clique em Adicionar bloco → Apps → “Reval”.
- Salve. O bloco se acomoda sozinho junto aos botões de compra (quantidade → opções → botão de assinar), onde quer que você o deixe.

Preview do buy box com a opção de assinatura ativa
- No editor de temas abra a página (por exemplo Páginas → sua landing) e adicione uma seção Apps (ou qualquer seção que aceite blocos de apps).
- Adicionar bloco → Apps → “Reval · Seção de assinatura”.
- Nas configurações do bloco escolha os produtos (até 12). Com dois ou mais, o comprador vê um cartão por produto; se o produto tiver variantes, elas aparecem como botões para escolher.
- Opcional: nomes curtos para os cartões (um por linha, na ordem da lista — “Laranja” em vez de “Eletrólitos Laranja x30”), título da lista de produtos, título, texto introdutório, benefícios e texto do botão.
- Opcional, para a imagem do produto:
- Mostrar a imagem do produto: liga ou desliga a imagem ao lado dos cartões.
- Fixar a imagem ao rolar: em telas largas, a imagem e os cartões acompanham a rolagem enquanto se lê a coluna da direita. Em celulares não tem efeito.
- Ajuste da imagem: Recortar para preencher o quadro (pode cortar as bordas) ou Mostrar inteira (sem recortar), com espaço ao redor se precisar.
- No editor de temas abra Incorporações de apps (App embeds) na barra lateral.
- Ative “Reval · Carrinho de assinaturas” e salve.
- Antes de adicionar um produto, a Reval verifica se ele pode ser assinado (plano ativo para essa frequência, estoque e o máximo de assinaturas novas por dia). Se não puder, mostra o mesmo aviso do checkout.
- Cada frequência é uma assinatura. O Mercado Pago cobra cada assinatura com uma única frequência, então um carrinho com produtos mensais e bimestrais cria duas assinaturas. O comprador paga uma única vez ao assinar, mas a partir daí vê um débito por frequência. O carrinho avisa antes do pagamento.
- O carrinho de assinaturas é separado do carrinho da loja: as compras únicas continuam sendo pagas no checkout da Shopify. O carrinho explica isso acima dos produtos e avisa no rodapé que os cupons da loja valem apenas para compras únicas.
- Os produtos ficam salvos no navegador do comprador até ele pagar ou removê-los.
- Botão flutuante: aparece em todas as páginas quando há produtos no carrinho, embaixo à direita ou à esquerda.
- Tipografia: por padrão o carrinho usa a do tema. Você pode escolher uma fonte própria e o tamanho da letra para o carrinho inteiro.
- Estilo: cor dos botões e do texto deles, fundo do carrinho, cor do texto e arredondamento dos botões. Vazio ou 0 = o valor do tema. Preencha só se quiser forçar outro.
- Botões separadamente: «Adicionar ao carrinho» (o que substitui o «Assinar» do bloco enquanto o carrinho está ativo), «Continuar para o pagamento» e o botão flutuante têm cada um sua cor, cor do texto, arredondamento e tamanho da letra, que sobrepõem os do grupo Estilo. Se você também pintou o botão pelo bloco «Reval» da página de produto, o ajuste do bloco prevalece.
- Textos: o título do carrinho, o aviso de carrinhos separados e a observação sobre cupons. Vazio = texto padrão.
- Aviso no carrinho da loja: adiciona no carrinho do tema uma mensagem explicando que as assinaturas são pagas à parte, com o link «Ver minhas assinaturas». Depende do tema: se não aparecer ou ficar em um lugar estranho, desative.
Adicione o link do portal à conta do cliente
- Na Shopify: Configurações → Contas de cliente e abra o editor de personalização das páginas da conta (botão Personalizar).
- Vá até a página Perfil e clique em Adicionar bloco → Apps → «Mi Suscripción» (o bloco de assinatura da Reval).
- Salve.
Faça uma assinatura de teste
- Abra a página do produto onde o buy box aparece em uma janela anônima.
- Escolha o plano de teste e finalize o checkout com um cartão real.
- Verifique se:
- O pedido aparece em Pedidos dentro do admin da Shopify, com as tags
Suscripción,Primera compraeCiclo 1(as tags são emitidas em espanhol). - A assinatura aparece em Assinaturas dentro da Reval, com status ativo.
- O mandato consta no seu painel do Mercado Pago.
- O pedido aparece em Pedidos dentro do admin da Shopify, com as tags
- Cancele a assinatura de teste e estorne a cobrança pelo painel do MP.
Cadastre o cartão de faturamento