Idioma
A Reval funciona em um idioma por loja: Español (Argentina) (o padrão), Español (Latinoamérica) ou Português (Brasil). As duas variantes de espanhol se diferenciam no tratamento: a da Argentina usa o voseo («pausá», «gestioná») e a da América Latina o tuteo («pausa», «gestiona»). O seletor troca a app inteira de uma vez —o admin, o checkout, o portal do cliente, o montador de caixas e a seção «Minha Assinatura» da conta do cliente— e a mudança passa a valer ao salvar, sem reinstalar nada. Os textos padrão dos blocos do tema (buy box, landing e carrinho de assinaturas) também o seguem: a Shopify os resolve pelo idioma da loja online, e como «Español (Latinoamérica)» não existe lá, uma loja que publica «Español» a secas via o widget com voseo; agora, com a Reval em Español (Latinoamérica) e um comprador navegando em espanhol, saem em tuteo. Os textos que você mesmo escreveu no bloco não são tocados. Exige a versão atualizada da extensão (publicada com o app).- Os textos que você escreve não são traduzidos: nomes de planos, textos das caixas, benefícios do buy box. Escreva-os no idioma que escolheu.
- Na instalação, a Reval detecta o idioma da sua loja e começa nele (uma loja em português começa em Português; as demais, em Español). A detecção roda uma única vez: se depois você trocar o idioma manualmente, nada sobrescreve sua escolha.
Integrações — Mercado Pago
É o primeiro item a preencher: sem credenciais, o checkout de assinaturas não funciona.Não há conexão por OAuth. As credenciais são copiadas do seu painel do Mercado Pago e coladas aqui. Ficam salvas de forma criptografada na configuração da sua loja, e nem o access token nem o webhook secret voltam a ser exibidos depois de salvos.
Depois de salvar, use Testar conexão. Se tudo estiver certo, você verá o nome da sua conta do Mercado Pago. Se aparecer um nome que não é o seu, o token está errado: pare e revise antes de continuar.
Checkout
A Reval usa um checkout próprio, então a configuração de campos do checkout nativo da Shopify não se aplica. Estes controles a replicam:
Se na Shopify você renomeou o campo Empresa (por exemplo para «Bairro»), escreva o mesmo texto em Nome do campo Empresa para que o checkout da Reval o mostre igual. O valor continua indo no campo Empresa do endereço de cada pedido, como no checkout da Shopify. Vazio = «Empresa».
Os valores padrão reproduzem o comportamento atual do checkout, então se você não mexer em nada, nada muda.
Documento fiscal
Se você precisa do identificador fiscal do cliente para faturar (CPF/CNPJ, CUIT/CUIL, RUT, RFC…), ative Pedir o documento fiscal como Opcional ou Obrigatório:- Nome do campo: o texto que o cliente vê no checkout, por exemplo «CPF/CNPJ». Vazio = «Documento fiscal».
- O campo aparece no checkout abaixo de Empresa. Se for obrigatório, o cliente não consegue continuar sem preenchê-lo. A Reval não valida o formato.
- O valor fica salvo na assinatura e vai em cada pedido da Shopify que ela gera —o primeiro, as renovações e os pedidos manuais— como um atributo do pedido, com o nome do campo como chave (por exemplo,
CPF/CNPJ: 123.456.789-09). - Você o vê e pode corrigi-lo no detalhe da assinatura, e ele também aparece no perfil do cliente.
É diferente do documento do formulário do cartão (DNI, RUT, CPF…), que vai direto para o Mercado Pago para validar o pagamento e que a Reval não guarda.
O checkout também se adapta sozinho ao mercado da sua loja, conforme a moeda dela. Em lojas em pesos chilenos (CLP) ele pede o documento (RUT — aceita o formato do dia a dia,
12.345.678-K), o seletor de endereço oferece as 16 regiões do Chile, e todos os valores são cobrados e faturados em pesos inteiros, sem decimais. Em reais (BRL) ele pede CPF ou CNPJ —com validação do dígito verificador, para pegar o erro de digitação antes de tentar o pagamento—, o endereço ganha os campos brasileiros (bairro, e o número da rua em seu próprio campo) com o código postal no formato CEP (00000-000), e o seletor oferece os estados do Brasil. Em ARS ele pede DNI/CUIT como sempre. E para entregas no Chile ou na Colômbia o código postal é opcional —o Shopify não o exige nesses países e as tarifas de envio são cotadas por região ou departamento—, tanto no checkout quanto ao editar o endereço pelo portal do assinante ou pelo admin; nos demais países continua obrigatório. Nada disso se configura.Impostos
A Reval pega a configuração de impostos da Shopify no momento da assinatura e a fixa para os ciclos seguintes: a alíquota que vale para os produtos, se os preços já incluem o imposto e se a loja cobra imposto sobre o frete (Shopify → Configurações → Impostos, «Cobrar impostos sobre as taxas de frete»). Cada pedido de assinatura leva uma linha de imposto com a alíquota nominal do seu país (por exemplo 19 % ou 21 %), que é a que os apps de faturamento leem. Em lojas com preços com imposto incluso isso não muda o que o cliente paga: é o que o pedido informa.As assinaturas criadas antes de outubro de 2026 calculam o imposto só sobre os produtos. Se a sua loja cobra imposto sobre o frete e você quer que essas assinaturas também o informem, peça à equipe da Reval: é um ajuste feito uma vez por loja. Os complementos de compra avulsa que vão em um pedido de assinatura ainda não entram na linha de imposto.
Frete no checkout
O checkout da Reval cota o frete com as mesmas tarifas da Shopify que a sua loja usa para qualquer compra e as agrupa em Entrega em casa e Retirada em ponto. Ele nunca pré-seleciona um ponto de retirada: se a sua transportadora oferece agências, o cliente precisa escolher uma de propósito. O método escolhido fica fixado para a assinatura e se repete a cada ciclo (veja Frete grátis e as edições). Se a sua loja tem tarifas configuradas e o cliente informa um endereço para o qual a Shopify não oferece nenhuma, o checkout mostra «O frete não está disponível para este endereço» e não deixa pagar, como o checkout nativo. Só uma loja sem nenhuma tarifa configurada continua vendendo com «Envío a coordinar» a $0. Zonas de frete. Em Pedidos e estoque → Zonas de frete você pode ajustar o que a cotação devolve, por código postal de entrega: cada regra lista códigos (exato01310100, prefixo 013*, intervalo 1700-1799, ou * para todos os endereços) e escolhe uma ação — ocultar um método (cujo título contém o que você digitar), renomeá-lo (só muda o nome que o cliente vê; o código que o seu app de fulfillment lê não é tocado) ou marcar a zona como sem cobertura, que bloqueia a compra com «O frete não está disponível». As regras se aplicam a tudo o que cota frete: os checkouts de produto, carrinho e caixas, e as recotações ao editar ou reativar uma assinatura. Sem regras definidas, nada muda. As regras vivem na Reval: se você mudar as zonas no seu app de frete, atualize-as aqui também.
Marca
A Reval usa um checkout próprio, então estes ajustes definem a aparência dele. Aplicam-se ao checkout, à página de agradecimento e à landing das caixas — sempre, inclusive quando o cliente chega por um link direto.
Cada valor segue a precedência o que você define aqui → o que o bloco do buy-box pega do tema → o valor padrão. Se você não preencher nada, o checkout fica como está hoje. Ao salvar, valida-se a cor (hex/rgb) e as URLs (
https://), e a tela mostra um preview ao vivo.
Este é o lugar recomendado para o logo, a cor e o favicon do checkout: tem prioridade sobre o logo que você pode definir nas configurações do bloco do buy-box e sobre a cor que o bloco pega do tema.
Pedidos e estoque
Limites de geração
Máximo de pedidos por assinatura por dia. Um teto de segurança contra a geração de pedidos em excesso para uma mesma assinatura. Colocar 0 deixa sem limite. Não afeta as cobranças automáticas do Mercado Pago: essas são idempotentes por pagamento, e travá-las faria perder pedidos já pagos. Máximo de assinaturas novas por cliente por dia. Controle antiabuso no checkout, para o padrão de abrir várias assinaturas com desconto no mesmo dia e cancelá-las antes da segunda cobrança. Conta toda assinatura criada nas últimas 24 horas, incluindo as canceladas. Colocar 0 deixa sem limite.Pedidos combinados (auto-merge)
Se um cliente tem várias assinaturas com o mesmo endereço de entrega e as cobranças caem com poucos dias de diferença, a Reval pode enviá-las em um único pedido da Shopify (um único envio) em vez de um por assinatura. Combinar em um único pedido as assinaturas de um mesmo cliente cobradas juntas. Desativado por padrão. Ao ativar, aparece a janela: combinar assinaturas cobradas com até N dias de diferença (vazio = 1 dia). Como funciona: quando o ciclo de uma assinatura é cobrado e o mesmo cliente tem outra assinatura ativa, com o mesmo endereço, cuja cobrança cai dentro da janela, o pedido da primeira cobrança espera a segunda. Quando essa segunda cobrança chega, os dois ciclos saem em um único pedido com a tagPedido combinado, uma linha de frete por assinatura e cada produto marcado com a frequência da sua assinatura. Se a segunda cobrança não chegar dentro da janela, for recusada ou a outra assinatura deixar de estar ativa, o pedido retido sai sozinho.
As cobranças não mudam. O Mercado Pago debita cada assinatura na sua própria data e pelo seu próprio valor; o que se combina é o pedido e o envio. O total do pedido combinado é sempre a soma das cobranças. Por isso a espera pode atrasar esse envio até o máximo da janela — escolha uma janela curta se a sua operação despacha no mesmo dia.
Caixas dinâmicas não são combinadas. O pedido combinado aparece uma única vez em Pedidos e no perfil do cliente, e o histórico de cada assinatura registra «Pedido combinado con …» (combinado com …).
Frete grátis nas assinaturas
A Reval cota o frete de cada assinatura com as mesmas tarifas da Shopify que a sua loja usa para qualquer compra, e a Shopify não distingue uma assinatura de uma compra única. Se você configurar frete grátis na Shopify, dá o frete em todas as vendas. Esta opção permite oferecer «assine e o frete é grátis» sem mexer nas compras únicas. Oferecer frete grátis nas assinaturas. Desligado por padrão. Ao ativar, o método de entrega que o cliente escolhe no checkout da Reval sai como grátis: a primeira cobrança e todas as renovações vão sem custo de frete. Vale também para o checkout do montador de caixas e para a reativação de uma assinatura. O pedido de cada ciclo na Shopify mantém a linha de frete em R$ 0 com o nome do método, então o seu fulfillment (e o seu app de envios) continua vendo o mesmo método de sempre. Valor mínimo por entrega para frete grátis (opcional). É um valor em dinheiro, na moeda da loja — não uma quantidade de itens. Vazio = sempre grátis. Se você informar um valor, o frete é grátis só quando o total de produtos da entrega (sem frete) chega a esse mínimo; abaixo dele, a tarifa da Shopify é cobrada como sempre. O mínimo vai na moeda da loja e é comparado com o preço regular do plano: o desconto do primeiro pedido não conta, um desconto fixo combinado para a assinatura sim.As edições respeitam a regra. Se um cliente muda quantidades ou produtos pelo portal (ou você pelo admin) e a assinatura deixa de atingir o mínimo, o frete volta a ser cobrado a partir do ciclo seguinte, e o detalhamento do portal mostra isso. Se uma edição a leva acima do mínimo, passa a ser grátis a partir do ciclo seguinte. O Mercado Pago nunca altera uma cobrança em andamento.
As assinaturas existentes não mudam sozinhas. A opção vale para as assinaturas novas e para as que forem editadas a partir da ativação; as que já existiam mantêm o frete que tinham até a próxima edição. O mesmo ao desativar: uma assinatura criada com frete grátis o mantém até ser editada. As compras únicas no checkout da Shopify não são afetadas em nenhum caso.
O frete grátis vale para o método que o cliente escolhe, inclusive os mais caros (por exemplo, expresso). Se você oferece vários métodos e não quer dar o mais caro, deixe disponíveis na Shopify só os que quiser cobrir para esses produtos. Para mostrar o benefício no buy-box, adicione-o ao texto de benefícios do bloco.
Produtos sem estoque
O que fazer quando chega o momento de criar o pedido do ciclo e falta estoque. O cliente já foi cobrado pelo Mercado Pago, então não existe uma opção sem consequências:A opção de nova tentativa tem um limite de tentativas, após o qual o ciclo é marcado como esgotado e deixa de ser tentado. Isso aparece no detalhe da assinatura.
Produtos sem controle de estoque («Não rastrear estoque» na Shopify): podem ser assinados e seus pedidos são criados normalmente em qualquer um desses modos. O Reval só considera uma variante sem estoque quando a política é «negar» e a quantidade rastreada é zero ou menos — um produto não inventariado sempre conta como disponível (e, como não tem estoque, seus pedidos não descontam nada).
Quais produtos são oferecidos como add-on e quais podem ser trocados ou adicionados a uma assinatura não é definido aqui, e sim por produto, em Produtos.
Permitir pular a próxima entrega
Adiciona um botão “Pular” no portal do cliente: ele omite uma entrega sem cancelar nem pausar a assinatura, pensado para o cliente que acumulou produto e que, do contrário, cancelaria. Vem desativado. Antes de ativar, vale saber como funciona por dentro, porque há uma consequência visível:Só é possível pular uma entrega por vez e —igual a pausar e cancelar— a opção não aparece até o cliente completar o compromisso mínimo de entregas do plano dele, se o plano tiver um. Enquanto o salto está em curso, o cliente vê “Cancelar salto”, que o devolve ao calendário normal.
O salto emite o evento “Ciclo pulado” (e não “Assinatura pausada”), então os seus flows de winback não perseguem alguém que só tinha produto sobrando.
Checkouts e carrinhos abandonados
Registrar os checkouts e carrinhos abandonados da Reval. Desligado por padrão: são dados pessoais de pessoas que não compraram, e enquanto está desligado nada é salvo nem emitido. Ao ativar, quando um cliente informa o e-mail no checkout da Reval e não conclui o pagamento, a tentativa fica em Pedidos → Checkouts abandonados com os dados dele, os produtos e um link para retomar a compra, e sai o evento «Checkout iniciado» para o Klaviyo e para os webhooks. O carrinho de assinaturas é registrado com a mesma opção («Carrinho iniciado») quando a Reval sabe quem é o cliente. Os registros são apagados após 90 dias sem atividade. O que é salvo, os status da lista e como montar o e-mail de recuperação: Checkouts abandonados.Banner do portal
Uma imagem exibida no portal, acima dos cartões de assinatura e dentro de cada um. Foi pensada para que todo o texto e a chamada para ação venham dentro da imagem — a Reval não sobrepõe texto por cima.Integrações — Klaviyo
A Reval pode emitir os eventos do ciclo de vida das assinaturas para você montar fluxos de boas-vindas, recuperação ou winback. Os quinze que são enviados: Assinatura criada · Cobrança de assinatura · Cobrança falhada · Renovação próxima · Produto sem estoque na assinatura · Produto disponível novamente · Produto excluído na assinatura · Assinatura pausada · Assinatura retomada · Assinatura cancelada · Assinatura finalizada · Meio de pagamento atualizado · Surpresa aplicada · Ciclo pulado · Pedido combinado Com Checkouts e carrinhos abandonados ativado, somam-se três eventos que ainda não têm assinatura: Checkout iniciado, Carrinho iniciado e Carrinho esvaziado. Como montar o fluxo de recuperação com eles: Checkouts abandonados.Dentro do Klaviyo os nomes das métricas e os textos de cada evento (a etiqueta de frequência, a data da próxima cobrança, o motivo de uma cobrança recusada, de uma pausa ou de um cancelamento) seguem o idioma configurado da loja: em português («Assinatura criada», «Cobrança de assinatura», «Cobrança falhada», «Renovação próxima», «Produto sem estoque na assinatura», «Produto disponível novamente», «Produto excluído na assinatura», «Assinatura pausada», «Assinatura retomada», «Assinatura cancelada», «Assinatura finalizada», «Meio de pagamento atualizado», «Surpresa aplicada», «Ciclo pulado», «Pedido combinado») para lojas em português, e em espanhol para lojas em espanhol. É isso que você seleciona no editor de fluxos. No Klaviyo o nome da métrica é a identidade do evento: se você mudar o idioma da loja, os eventos passam a chegar com o nome novo e os fluxos vinculados ao nome anterior deixam de disparar até você vinculá-los de novo. As propriedades brutas usadas em condições (
status, frequency_type, valores, datas ISO, reason_key) não mudam com o idioma.Lembrete de renovação
O campo “Lembrete de renovação (dias antes da cobrança)” faz a Reval emitir o evento “Renovação próxima” essa quantidade de dias antes da próxima cobrança, uma vez por ciclo, através de um processo diário. É a matéria-prima do e-mail “vamos cobrar você em N dias” — que reduz recusas e reclamações. Em 0 fica desativado, e ele só é enviado se o Klaviyo ou o Shopify Flow estiverem ativados.Shopify Flow
Você também pode ativar o disparador Evento de assinatura para o Shopify Flow e construir as suas automações lá: um workflow com esse trigger e uma condição sobre o evento (por exemplo,event = cancelled) pode enviar um e-mail com o Shopify Email ou etiquetar o cliente. Vem desativado, então nenhuma chamada extra é feita até você habilitá-lo.