Integração Pagaleve - Pix Parcelado
A Pagaleve oferece a solução de Pix Parcelado para impulsionar as vendas online do seu negócio. Com essa modalidade, seus compradores podem parcelar compras em até 4 vezes via Pix sem risco de chargeback para a sua loja, auxiliando na atração de novos públicos, no aumento do ticket médio e na conversão no checkout.
A plataforma conta com a verificação antecipada de elegibilidade de crédito no pré-checkout. O sistema valida se o comprador está apto a utilizar o crédito antes da finalização do pedido, garantindo transparência na compra e reduzindo a taxa de abandono de carrinho.
Por que utilizar o Pix Parcelado via Pagaleve?
- Zero risco de chargebacks: garantia de recebimento para a loja.
- Validação antecipada de crédito: a consulta de elegibilidade é feita no pré-checkout de forma automática, sem travar a navegação do comprador.
- Melhora na conversão: exibe a opção de pagamento parcelado apenas para compradores com perfil aprovado.
Como ativar a integração?
Atenção: antes de prosseguir com as etapas de configuração, realize a contratação do serviço e confirme se a sua conta na Pagaleve já está liberada para transacionar e receber pagamentos.
- No painel de administração da sua loja. acesse Configurações da loja > Pagamentos > Pix > Pagaleve Pix Parcelado.
- Clique nos três pontinhos e selecione a opção Editar os dados.

- Nesta próxima tela, preencha os seguintes dados:
- Username (usuário da API)
- Password (senha da API)
- Confirmar Pedidos automaticamente (caso queira habilitar)
- Descrição no pix

- Clique em Enviar.
- Clique novamente nos três pontinhos ao lado de Pagaleve e, em seguida, em Habilitar este meio de pagamento.
Realizados os trâmites de ativação, sua loja estará pronta para transacionar via Pix parcelado.
Como funciona a verificação antecipada de elegibilidade (Pré-checkout)
Assim que a integração está ativa, o sistema passa a realizar uma consulta automática de elegibilidade de crédito no pré-checkout para cada tentativa de compra.
Disparo da verificação e dados analisados
- Gatilho de consulta: a verificação é disparada automaticamente assim que o comprador preenche o CPF válido e o número de telefone celular completo nas etapas iniciais de identificação do checkout.
- Dados enviados: o sistema envia à API da Pagaleve as informações do comprador (CPF, telefone celular e e-mail) acompanhadas do valor total atualizado do carrinho.
Exibição na etapa de pagamento
- Comprador elegível: a opção de pagamento Pix Parcelado - Pagaleve é exibida normalmente na tela de seleção de pagamentos com o detalhamento das parcelas disponíveis.
- Comprador inelegível: a opção de pagamento Pix Parcelado - Pagaleve é ocultada automaticamente na etapa de pagamento.
Regras operacionais e comportamento do checkout
Alteração no valor do carrinho
Caso o valor total do carrinho seja modificado durante a navegação (como adição de cupom de desconto, alteração de endereço ou mudança no valor do frete), uma nova verificação de elegibilidade é disparada automaticamente com o valor corrigido.
Validação dos campos de cadastro
A requisição de elegibilidade só é enviada se os dados de CPF e telefone celular estiverem em formato correto e completo. Se houver erro de digitação, o sistema não realiza a chamada até que os campos correspondentes sejam corrigidos.
Comportamento em caso de instabilidade técnica
Caso a API externa da Pagaleve apresente lentidão, erro ou instabilidade durante a consulta:
O checkout segue o comportamento padrão.
- O processo de compra não é travado.
- O comprador pode concluir a venda normalmente selecionando outras formas de pagamento disponíveis na loja (como cartão de crédito, Pix tradicional ou boleto).