Conectores de Pagamento - Como configurar o Conector Pagaleve no Admin

Quem é a Pagaleve e qual o serviço disponibilizado?

Fundada em 2021, a Pagaleve é uma fintech que oferece a opção de pagamento Pix Parcelado em até 4x quinzenais sem juros, por meio de uma plataforma altamente tecnológica. Entre os benefícios oferecidos aos varejistas estão o aumento da taxa de conversão, elevação do ticket médio e a eliminação de riscos de inadimplência ou chargeback.

Com o surgimento de novas tendências e comportamentos de consumo, observa-se a expansão de modalidades de pagamento alternativas, como o Pix, que se consolidou como o favorito entre os desbancarizados. Isso ocorre porque o Pix não exige vínculo bancário ou linha de crédito – basta ter uma carteira digital. 

A seguir, neste conteúdo, vamos explicar como configurar a forma de pagamento Pagaleve como solução financeira para sua loja.

Como configurar o Conector Pagaleve no Admin

1ª Etapa: Contratação do serviço

2ª Etapa: Formas de Pagamento;

3ª Etapa: Grupos de Pagamento e Parcelamentos

4ª Etapa: Gestor de script

5° Etapa: Widget de calculador de parcelas (etapa opcional)

Confira o passo a passo das configurações dentro das suas respectivas etapas.

1ª Etapa: Contratação do serviço

A contratação do serviço deve ser feita diretamente com a Pagaleve para obter as informações necessárias de acesso. Para isso, basta acessar o site.

Para continuar, siga para a próxima etapa: "Formas de Pagamento."

2ª Etapa - Formas de Pagamento

Para criar um pagamento customizado clique em Pagamentos >> Conectores de Pagamento >> Conectores de Pagamentos F-Gateway.

Em seguida direcionar ao conector em>> Pagaleve - pix à vista ou Pagaleve- pix parcelado (dependendo do seu contrato com o parceiro) >> "Adicionar Configuração":

Cadastre um nome para a configuração e selecione o tipo Pix

Pix à vista:

Na sequência deverá ser preenchido os seguintes headers:

Api-Token: Dado fornecido pela Pagaleve diretamente em seu dashboard

Api-Key: Dado fornecido pela Pagaleve diretamente em seu dashboard

Acess_key: Chave de autenticação única fornecida pela plataforma para lojistas

Delay-Cancel-In-Minutes: Este campo define o tempo de espera (em minutos) para o cancelamento automático do pedido. Se deixado em branco, o cancelamento será realizado instantaneamente. Caso preenchido, o pedido será cancelado apenas após o intervalo estipulado, oferecendo uma janela de tempo para estratégias de recuperação do cliente.

Permitir Múltiplas Transações por Split? Essa feature flag deve ser ativada, caso a sua loja trabalhe com múltiplos CDs e seja feito o split de pagamento entre eles. Ao ser habilitada, o sistema enviará uma única requisição com todos os pagamentos gerados para cada divisão do pedido (split). Ponto importante é que, ao ser ativada no conector, a transação única deverá ser desativada dentro das configurações gerais do seu ADM, pois são features incompatíveis no momento. Para isso, basta acessar Configurações> Configurações gerais> Desabilitar a opção Gerar transação única para pedido de Split> Salvar:

Tipo Pagamento: Deverá ser preenchido com a forma de pagamento configurada, neste caso pix:

Pix à parcelado:

Na sequência deverá ser preenchido os seguintes headers:

Api-Token: Dado fornecido pela Pagaleve diretamente em seu dashboard

Api-Key: Dado fornecido pela Pagaleve diretamente em seu dashboard

Delay-Cancel-In-Minutes: Este campo define o tempo de espera (em minutos) para o cancelamento automático do pedido. Se deixado em branco, o cancelamento será realizado instantaneamente. Caso preenchido, o pedido será cancelado apenas após o intervalo estipulado, oferecendo uma janela de tempo para estratégias de recuperação do cliente.

Permitir Múltiplas Transações por Split? Essa feature flag deve ser ativada, caso a sua loja trabalhe com múltiplos CDs e seja feito o split de pagamento entre eles. Ao ser habilitada, o sistema enviará uma única requisição com todos os pagamentos gerados para cada divisão do pedido (split). Ponto importante é que, ao ser ativada no conector, a transação única deverá ser desativada dentro das configurações gerais do seu ADM, pois são features incompatíveis no momento. Para isso, basta acessar Configurações> Configurações gerais> Desabilitar a opção Gerar transação única para pedido de Split> Salvar:

Tipo Pagamento: Deverá ser preenchido com a forma de pagamento configurada, neste caso pix:

3ª Etapa - Grupos de Pagamento e Parcelamentos

Após as primeiras configurações, você deverá clicar em Grupos e Parcelamentos >> Parcelamentos e seguir o passo a passo completo no artigo Grupos e Pagamentos.
 

Importante: Se a sua loja deseja oferecer as duas opções de pagamento, Pix à vista e Pix parcelado, será necessário criar dois grupos de pagamento distintos. Esses grupos serão associados posteriormente no script da loja, conforme será detalhado nos próximos passos.

4ª Etapa: Gestor de script

Finalizada a etapa acima, é necessário que o script seja inserido, para isso no menu Configurações, selecione a configuração Configurações >> Gestor de Scripts >> "Adicionar Script".

Preencha os dados conforme instruído abaixo, em nome digite "Pagaleve" e marque ok na opção "script ativo?":

Script lojistas checkout 1.0:

Em "Posição", selecione "Header - Primeira linha". Na opção "Páginas", escolha "Todas". No campo "Identificador de página", insira "*". Em seguida, no campo de conteúdo do script, insira o seguinte trecho de código:
 

<script>
    var merchantId= "*************";
    var paymentMethodName = "***";
    var upfrontPaymentMethodName = "***";
</script>
<script src="https://provider-public-assets.pagaleve.com.br/wake/checkout.wake-v2.pagaleve.js"></script>

Script lojistas checkout 2.0:

Em "Posição", selecione “Body-Última linha". Na opção "Páginas", escolha "Todas". No campo "Identificador de página", insira "*". Em seguida, no campo de conteúdo do script, insira o seguinte trecho de código:

<script>
    var merchantId= "*************";
    var paymentMethodName = "***";
    var upfrontPaymentMethodName = "***";
</script>
<script src="https://provider-public-assets.pagaleve.com.br/wake/checkout.wake-v2.pagaleve.js"></script>

Pontos importantes no preenchimento do script:

• merchantId: É uma chave que deve ser fornecida pela Pagaleve

• PaymentMethodName: Identifica o nome do método Pagaleve de pagamento parcelado e deve ser preenchido igual ao nome criado no seu grupo de pagamentos

• UpfrontPaymentMethodName:Identifica o nome do método Pagaleve de pagamento à vista  e deve ser preenchido igual ao nome criado no seu grupo de pagamentos

Finalizado o processo, você deve clicar em salvar e depois publicar:

5ª Etapa: Widget de calculador de parcelas (etapa opcional)

O Widget Calculador de Parcelas é um componente exibido nas páginas de produto ou checkout de uma loja virtual que permite ao consumidor simular o valor das parcelas disponíveis para um determinado produto ou pedido, com base nas condições de pagamento definidas pela loja ou pelo meio de pagamento.

Exemplo:

Alguns benefícios:

Transparência para o cliente:O consumidor visualiza antecipadamente o valor das parcelas e as condições (com ou sem juros), evitando surpresas no checkout.

Melhor experiência de compra: O cliente não precisa ir até o carrinho para simular o pagamento, tornando a navegação mais fluida e informativa.

Autonomia na decisão: O comprador consegue escolher a melhor condição de parcelamento com base no que cabe no seu orçamento.

Disponibilização na loja

Caso o lojista queira oferecer essa funcionalidade, é necessário que entre em contato com a agência responsável pelo layout da loja para que o desenvolvimento seja feito com base na documentação disponibilizada pela Pagaleve. 

Recomendações Gerais:

• Visualização no checkout:

Após concluir todas as configurações descritas ao longo do conteúdo, a opção de pagamento "Pagaleve" deve aparecer no checkout da loja. Veja abaixo o demonstrativo:

Pix à vista:

Pix parcelado:

• Validação de direcionamento após finalização do pedido: Após finalização do pedido, confirme se o cliente será direcionado para as seguinte telas:

Pagamento com Pix à vista:

          Pagamento com Pix parcelado:

• Expiração do Pix: É necessário que o lojista realize a configuração dentro do próprio dashboard Pagaleve, após o prazo definido o pedido será cancelado na Pagaleve e no ADM Wake.