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 acessando a sua dashboard na 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.

Ponto importante:
Api-Key = Chave API Pagaleve

Api-Token = Senha API Pagaleve

2. Adicionar o(s) conector(es) Pagaleve

1. No painel Wake, acesse Pagamentos → Conectores de Pagamento.
2. Procure os conectores da Pagaleve
3. Temos 2 conectores: Pagaleve - Pix à vista e Pagaleve - Pix Parcelado
4. Clique no conector e selecionar adicionar conector

2.1 Configure o(s) seu(s) conector(es)

1. Configurando o Pix à vista
   1. Nome da configuração: Pagaleve - Pix à vista
   2. Api-Key: chave de API Pagaleve (Coletada dentro da dashboard Pagaleve)
   3. Api-Token: senha API Pagaleve (Coletada dentro da dashboard Pagaleve)

1. Confiurando o Parcelamento via Pix
   1. Nome a configuração: Parcelamento via Pix
   2. Api-Key: chave de API Pagaleve (Coletada dentro da dashboard Pagaleve)
   3. Api-Token: senha API Pagaleve (Coletada dentro da dashboard Pagaleve)

3. Crie e vincule os grupos de pagamento

1. Ainda em Pagamentos, acesse Gerenciamento de Pagamentos.
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 Pagaleve.
6. Clique em Vincular configurações e selecione o conector Pagaleve.
7. Ambos os os conectores, Pagaleve devem ser vinculados com A vista.

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 (Opcional)

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. Configure o Gestor de Scripts

1. Acesse Configurações → Gestor de Scripts.
2. Clique em Adicionar Script.
3. Preencha os campos.
4. Salve o Script criado.

Adicione o script correspondente ao ambiente da loja.

Sandbox

<script>
  var auth = "Token gerado no passo 1";
  var paymentMethodName = "Pagaleve- Pix à vista"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento via Pix"; // 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 = "Pagaleve- Pix à vista"; // Use o nome de exibição do grupo Pix à vista.
  var upfrontPaymentMethodName = "Parcelamento via Pix"; // 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.