> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appreval.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuração completa da Reval na sua loja Shopify
> Escolha o idioma da app, conecte o Mercado Pago, defina os campos do checkout, as regras de pedidos e estoque, o banner do portal e as integrações com Klaviyo e Shopify Flow.
Acesse por **Reval → Configuração** no seu admin da Shopify. A tela tem sete blocos —Idioma, Mercado Pago, checkout, pedidos e estoque, banner do portal, Klaviyo / Shopify Flow e [Google Tag Manager](/pt/lojista/analitica)— e um botão de salvar no final: as mudanças passam a valer assim que você salva.
A Reval trabalha sempre com **credenciais de produção** do Mercado Pago. Não existe modo sandbox nem seletor de ambiente: os testes são feitos com um cartão real e um valor baixo, que você estorna depois pelo painel do MP. Os cartões de teste do Mercado Pago não funcionam com credenciais produtivas.
***
## Idioma
A Reval funciona em **um idioma por loja**: Español (o padrão) ou Português. O seletor troca a app inteira de uma vez —o admin, o checkout, o portal do cliente e o montador de caixas— e a mudança passa a valer ao salvar, sem reinstalar nada.
* **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.
Os três valores de que você precisa, todos vindos da sua aplicação de produção no painel de desenvolvedores do MP:
| Campo | Onde obter |
| ------------------ | --------------------------------------------------------- |
| **Public key** | Credenciais de produção |
| **Access token** | Credenciais de produção |
| **Webhook secret** | A *chave secreta* que o MP mostra ao configurar o webhook |
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.
O nome de conta que o teste devolve é a melhor verificação que você tem. Um token de outra conta não dá erro — simplesmente cobraria na conta errada.
***
## 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:
| Opção | O que faz |
| -------------------------------- | ------------------------------------------------------------------- |
| **Mostrar a caixa de marketing** | Mostra ou oculta o opt-in de comunicações |
| **Pré-marcar a caixa** | Vem desmarcada por padrão |
| **Exigir nome** | A maioria das transportadoras precisa dele para a etiqueta de envio |
| **Empresa** | Oculto, opcional ou obrigatório |
| **Complemento / andar** | Oculto, opcional ou obrigatório |
| **Telefone** | Oculto, opcional ou obrigatório |
Os valores padrão reproduzem o comportamento atual do checkout, então se você não mexer em nada, nada muda.
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. Nada disso se configura.
***
## 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.
### 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:
| Opção | O que acontece |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Gerar o pedido de todo modo (backorder)** | É criado com tudo. É o padrão |
| **Pedir só os produtos com estoque** | É criado com o que está disponível. Pode sobrar uma diferença a estornar manualmente, e se nada estiver em estoque o pedido não é criado |
| **Tentar novamente no dia seguinte** | É diferido e o estoque é verificado diariamente até ser possível criá-lo |
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.
**Mostrar produtos sem estoque** controla se as variantes esgotadas aparecem na lista de add-ons do portal e nos seletores de troca de produto.
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](/pt/lojista/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:
| | |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **O que o cliente vê** | Um botão "Pular" ao lado de "Pausar", com uma confirmação que informa qual entrega é pulada e para quando passa a seguinte |
| **O que a Reval faz** | O Mercado Pago não permite omitir uma cobrança, então o débito é **pausado e reativado automaticamente** um ciclo depois. Mesma assinatura: mesmo preço, mesmos produtos, mesmo cartão, mesmo histórico |
| **As letras miúdas** | A data da cobrança posterior é decidida pelo Mercado Pago ao reativar o mandato. Ela pode se deslocar em relação à prometida; a Reval lê a data real e atualiza o portal. **O ciclo pulado nunca é cobrado** |
| **No admin** | A assinatura continua constando como **Ativa** —pular não é pausar nem cancelar, e não conta como perda no painel— com um aviso no detalhe dizendo que há um salto em curso e quando ele se reativa sozinho |
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.
***
## 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.
| Campo | Detalhe |
| --------------------- | -------------------------------------------------- |
| **Ativar banner** | Interruptor geral |
| **Imagem de desktop** | URL https, proporção aproximada de 3:1 |
| **Imagem mobile** | Opcional; se você não enviar, é usada a de desktop |
| **Link** | Destino opcional ao clicar |
| **Abrir em nova aba** | Para o link acima |
***
## 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 quatorze 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**
Dentro do Klaviyo os nomes das métricas aparecem em **espanhol** — são strings estáveis emitidas pelo app («Suscripción creada», «Cobro de suscripción», «Cobro fallido», «Renovación próxima», «Producto sin stock en suscripción», «Producto disponible nuevamente», «Producto eliminado en suscripción», «Suscripción pausada», «Suscripción reanudada», «Suscripción cancelada», «Suscripción finalizada», «Medio de pago actualizado», «Sorpresa aplicada», «Ciclo saltado») — então é isso que você vai selecionar no editor de fluxos.
Precisa de uma **private API key** do Klaviyo. A emissão exige que a integração esteja ativada e a chave carregada, e é sempre best-effort: se o Klaviyo falhar, nem a cobrança nem a criação do pedido são interrompidas.
### 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.
A Reval não envia e-mails por conta própria. Qualquer notificação ao assinante —confirmação, aviso de cobrança recusada, lembrete— sai dos fluxos que você construir no Klaviyo ou no Shopify Flow. Se você não configurar nenhum, os seus clientes não recebem nada da parte da Reval.
***
## Salvar
As mudanças passam a valer ao salvar. As credenciais do Mercado Pago têm um cache curto que se invalida sozinho ao salvar, então uma troca de token toma efeito imediatamente.