- A funcionalidade de Recorrência da Pagar.me permite realizar cobranças automáticas periódicas utilizando cartão de crédito.
- É indicada para lojas que trabalham com assinaturas, mensalidades, clubes de assinatura ou qualquer serviço com cobrança recorrente.
- O sistema gerencia automaticamente o ciclo da assinatura, incluindo cobranças, renovações e cancelamentos.
Passo a Passo por Escrito
1. Ativar a Configuração de Recorrência
Dentro do painel Magento, acesse:
Lojas → Configuração → Vendas → Recorrência — Pedido por ciclo
- Clique no campo Gerar pedido por ciclo de recorrência
- Selecione Sim

Resultado esperado: O módulo estará ativo.
2. Configurar a Recorrência da Pagar.me
Acesse:
Lojas → Configuração → Vendas → Forma de Pagamento → Pagar.me → Configurações de Recorrência
Configure os campos conforme a necessidade da sua loja.

| Campo | Descrição |
|---|---|
| Ativar essa solução | Habilita ou desabilita o módulo de recorrência na loja. |
| Realizar a cobrança do frete | Define se o valor do frete será cobrado em cada ciclo da assinatura. |
| Realizar a cobrança das taxas | Define se taxas adicionais serão cobradas junto com cada recorrência. |
| Mostrar widget de moeda de recorrência | Exibe um widget com informações sobre a moeda utilizada nas cobranças recorrentes. |
| Permitir compra com outro produto | Permite adicionar no mesmo pedido produtos recorrentes e produtos comuns. |
| Mensagem de conflito de checkout | Mensagem exibida ao cliente quando a compra contém uma combinação de produtos não permitida pelas regras de recorrência. |
| Permitir compra com outro produto recorrente | Define se é permitido adquirir mais de um produto recorrente no mesmo pedido. |
| Mensagem de conflito do checkout | Mensagem personalizada exibida quando ocorre um conflito nas regras de compra durante o checkout. |
| Atualizar o estoque do produto a cada ciclo | Atualiza automaticamente o estoque do produto recorrente a cada nova cobrança realizada. |
Resultado esperado: Os campos de configuração da recorrência foram preenchidos conforme a necessidade da loja e estão prontos para serem salvos.
3. Configurar os Produtos de Recorrência
Acesse:
Pagar.me → Produtos de recorrência
- Pesquise o produto desejado no campo Product Search
- Selecione o produto para configurar sua recorrência

Configure os campos conforme desejado.
| Campo | Descrição |
|---|---|
| Forma de Pagamento | Define quais formas de pagamento estarão disponíveis para a assinatura, como Cartão de Crédito e/ou Boleto. |
| Allow sell as normal product | Permite que o produto também seja vendido como um produto comum, sem recorrência. |
| Desconto de carrinho | Define se os descontos aplicados no carrinho também serão utilizados em todas as cobranças futuras da assinatura. |
| Repetitions - Intervalo | Define o intervalo entre cada renovação da assinatura. |
| Repetitions - Tipo | Determina a unidade de tempo utilizada no intervalo: dia, semana, mês ou ano. |
| Repetitions - Preço recorrente | Valor que será cobrado em cada renovação da assinatura. Pode ser diferente do preço inicial, caso haja desconto. |
| Repetitions - Ciclos | Quantidade de cobranças que serão realizadas antes do encerramento automático da assinatura. |
Resultado esperado: O produto foi configurado com as opções de recorrência e está pronto para ser salvo.
4. Salve as configurações
Clique no botão Salvar no canto superior direito da tela.
Resultado esperado: Uma mensagem de "A configuração foi salva" será exibida no topo da tela e o cache estará atualizado.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Verifique se a recorrência exibe na página do produto
Ação: verifique a página do produto configurado com recorrência.
Resultado esperado: O produto será exibido com recorrência para selecionar.
Se não funcionar, verifique:
- A opção Gerar pedido por ciclo de recorrência está configurada como Sim.
- A recorrência da Pagar.me está ativada.
- O produto foi configurado como produto de recorrência.
- Os campos de intervalo, tipo, preço recorrente e ciclos foram preenchidos corretamente.
- As configurações foram salvas
Pronto! Dessa forma realizamos a configuração da Recorrência Pagarme em sua loja virtual Magento 2.
Observações Importantes
- A recorrência é configurada individualmente para cada produto.
- O comportamento da assinatura seguirá os parâmetros definidos na configuração do produto.
- Alterações realizadas nas configurações passam a valer para as próximas cobranças da assinatura.
Referências e Relacionados
- Produto Simples
- Produtos Configuráveis
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br.