Configuração do método de pagamento Pagaleve

Ative o conector Pagaleve para oferecer Pix à vista e Parcelamento no Pix em uma loja Wake Commerce.

Pré-requisitos

Antes de começar:

• Acesse o painel administrativo Wake da loja que você quer configurar.
• Obtenha a chave de API e a senha ou token de acesso com o time Pagaleve.
• Confirme com o time Pagaleve se a loja opera como marketplace (múltiplas lojas ou CDs no mesmo portal Wake). Essa configuração inclui uma etapa adicional em Lojas marketplace.

1. Confirme as credenciais Pagaleve

Use a Api-Key e o Api-Token fornecidos pelo time Pagaleve para autenticar a comunicação entre a Wake e o conector Pagaleve. Tenha os dois valores disponíveis antes de continuar.

2. Crie o conector de pagamento customizado

1. No painel Wake, acesse Pagamentos → Conectores de Pagamento (F-Gateway).
2. Na opção Custom, clique em Nova Configuração.
3. Informe um nome para a configuração, como Pagaleve.
4. Selecione a forma de pagamento Customizado e clique em Adicionar Configuração.

A configuração será criada em branco. Preencha os campos abaixo e clique em Atualizar.

3. Crie e vincule os grupos de pagamento

1. Em Pagamentos, acesse Grupos e Parcelamentos.
2. Clique em Criar Grupos.
3. Crie um grupo para Pix à vista e outro para Parcelamento no Pix.

Para cada grupo:

1. Informe o nome escolhido nos campos de nome do grupo e nome de exibição.
2. Deixe os valores mínimo e máximo como 0.
3. Habilite Validar limite de crédito.
4. Salve o grupo.
5. Clique em Vincular formas de pagamento e selecione Customizado.
6. Clique em Vincular configurações e selecione o conector criado na etapa 2.

4. Crie o parcelamento À vista

1. No canto superior direito da tela, acesse Parcelamentos e crie um novo parcelamento caso não exista. Use as informações da imagem abaixo como referência.
2. Em Parcelamentos, clique em Criar parcelamento.
3. Preencha os valores abaixo e salve.

Depois de criar o parcelamento:

1. Abra cada um dos dois grupos de pagamento.
2. Clique em Vincular Parcelamento.
3. Selecione o parcelamento À vista.
4. Habilite os dois grupos pelos toggles.

O vínculo é obrigatório nos dois grupos, inclusive no grupo de Parcelamento no Pix.

5. Adicione os grupos à estrutura de pagamentos

1. Em Pagamentos, acesse Estrutura de Pagamentos.
2. Clique em Selecionar grupo de pagamento.
3. Adicione os dois grupos criados na etapa 3 à estrutura de pagamentos existente da loja.

6. Libere as URLs na política de segurança

1. Acesse Configurações → Políticas de Segurança → URLs Permitidas.
2. Clique em Adicionar Nova URL.
3. Cadastre cada domínio abaixo separadamente.

Preencha as rotas abaixo para liberação refazendo o processo acima uma por vez:

*.pagaleve.com.br
*.pagaleve.io

Aguarde cerca de 5 minutos para a propagação das permissões antes de testar o checkout.

7. Configure o Gestor de Scripts

1. Acesse Configurações → Gestor de Scripts.
2. Clique em Adicionar Script.
3. Preencha os campos da seguinte forma.

Adicione o script correspondente ao ambiente da loja.

Sandbox

<script>
  var auth = "Token gerado no passo 1";
  var paymentMethodName = "Pix - paga leve"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento no Pix - paga leve"; // Use o nome de exibição do grupo Parcelamento.
</script>
<script src="https://sandbox-provider-public-assets.pagaleve.io/wake/checkout.wake.pagaleve.js"></script>

Produção

<script>
  var merchantId = "merchantID Pagaleve";
  var paymentMethodName = "Pix - paga leve"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento no Pix - paga leve"; // Use o nome de exibição do grupo Parcelamento.
</script>
<script src="https://provider-public-assets.pagaleve.com.br/wake/checkout.wake-v2.pagaleve.js"></script>

8. Lojas marketplace (múltiplos CDs/lojas)

Se a loja usa a opção Múltiplos pagamentos por split em Gerenciamento de conectores, confirme com o time Pagaleve que o merchant está habilitado para split de pagamentos antes de testar.

Sem essa habilitação, a criação do pedido falha e o pedido permanece em Aguardando Pagamento, sem exibir o modal. Em grupos com múltiplos CDs ou lojas, vincule cada CD à chave de API Pagaleve da loja correspondente. Não use a chave da loja principal em todos os CDs, pois as vendas das lojas secundárias podem ser direcionadas à conta incorreta.

Checklist de ativação

• Confirmei a chave de API e o token no painel Wake.
• Usei o mesmo nome para grupo e nome de exibição nos dois grupos de pagamento.
• Criei o parcelamento À vista, com uma parcela e valor mínimo 0, e o vinculei aos dois grupos.
• Configurei o script com a nomenclatura correta, escopo * e posição Body — Última linha.
• Verifiquei se a loja usa Storefront 2.0 antes de manter ou remover o script manual.
• Liberei *.pagaleve.com.br e *.pagaleve.io.
• Testei o checkout para Pix à vista e Parcelamento no Pix.

Depois de concluir a configuração, siga para Teste seu checkout Wake.