A Shopify é a única fonte da verdade. Cada cobrança aprovada gera um pedido real na Shopify, com as linhas de produto, o custo de frete e os impostos calculados ao vivo. Não há banco de dados paralelo nem pedidos “fantasma”: o que você vê no seu admin da Shopify é o que foi realmente cobrado e será enviado.
Fluxo completo de uma assinatura
- Visão do lojista
- Visão do assinante
O que acontece na sua loja
Como lojista, a sua interação principal com a Reval acontece em dois momentos: a configuração inicial (planos, descontos, frequências) e a revisão dos relatórios. O dia a dia roda automaticamente.Criação da assinatura
1
O comprador escolhe um plano no buy box
Na página do produto aparece um seletor de planos com a frequência (semanal, mensal, bimestral, etc.) e o desconto associado a cada um. O comprador seleciona o plano e clica em “Assinar”.
2
Checkout customizado da Reval
O comprador informa os dados do cartão diretamente no checkout da Reval. A tokenização acontece no navegador, sem redirecionamento para o Mercado Pago. O servidor da Reval nunca vê o número completo do cartão.
3
Criação do mandato de cobrança recorrente com valor livre
A Reval cria um mandato de cobrança recorrente (preapproval) no Mercado Pago usando a modalidade de valor livre, ou seja, sem vinculá-lo a um plano fixo do Mercado Pago. Isso é indispensável porque um mandato vinculado a um plano do MP só pode cobrar um valor fixo, sem capacidade de somar frete, impostos ou descontos por cliente. Com valor livre, cada ciclo cobra o valor exato (produto + frete + impostos) consultado ao vivo nas tarifas reais da sua loja na Shopify.
4
Primeira cobrança e pedido na Shopify
A primeira cobrança é executada de imediato. Quando o Mercado Pago confirma o pagamento via webhook, a Reval cria o primeiro pedido na Shopify com todas as linhas, o frete e os impostos. Esse pedido entra no seu fluxo normal de fulfillment.
Ciclo recorrente
1
Cobrança automática pelo mandato
Na data do ciclo, o Mercado Pago executa a cobrança usando o mandato ativo. O valor é o que ficou fixado no mandato —produto, frete e imposto calculados no momento da criação— e só muda se alguém o atualizar explicitamente pelo admin ou pelo portal.
2
O webhook do MP chega à Reval
O Mercado Pago notifica o resultado da cobrança (aprovada ou recusada) por meio de um webhook. A Reval verifica a idempotência: se o evento já foi processado, ela o descarta sem criar um pedido duplicado.
3
Pedido criado na Shopify (cobrança aprovada)
Se a cobrança foi aprovada, a Reval cria imediatamente um pedido na Shopify com as linhas atuais da assinatura, o custo de frete e os impostos. O pedido fica disponível para fulfillment na hora.
4
Cobrança recusada
A Reval registra a falha com o motivo e a exibe no admin e no portal. O Mercado Pago tenta a cobrança novamente por conta própria; se as tentativas se esgotarem, ele cancela o mandato e a Reval marca a assinatura como cancelada. Nenhum pedido é criado até que haja uma cobrança aprovada.
Segurança e confiabilidade
A Reval foi desenhada para que cada operação seja segura e não gere estados inconsistentes:Tokenização no navegador
Os dados do cartão nunca passam pelos servidores da Reval. O SDK do Mercado Pago tokeniza diretamente no navegador do comprador.
Webhooks idempotentes
Cada evento do Mercado Pago é processado uma única vez. Se o webhook chegar duplicado, a Reval detecta e não cria um pedido extra.
Links assinados
O portal e o checkout usam links com assinatura criptográfica. Sem a assinatura correta, não há acesso.
Pedidos que não se perdem
Se uma cobrança é aprovada mas o pedido não pode ser criado —por exemplo, porque um produto ficou sem estoque— ele entra na fila e um processo diário tenta de novo até conseguir. O cliente já pagou: o pedido dele não se perde.