Pagaleve: como configurar Pix à vista e Pix parcelado na Uappi

A integração da Pagaleve com a Uappi permite disponibilizar pagamentos via Pix à vista e Pix parcelado no checkout da loja.

A Pagaleve é uma solução de pagamento no modelo Buy Now, Pay Later (BNPL), que permite ao consumidor realizar compras via Pix, inclusive de forma parcelada e sem a necessidade de cartão de crédito.

Na Uappi, as modalidades são disponibilizadas por meio de dois conectores:

  • Pagaleve Pix à vista
  • Pagaleve Pix Parcelado

Os conectores são configurados individualmente, permitindo que a loja disponibilize as modalidades de acordo com sua estratégia de pagamento.


O que está disponível na integração?

Meios de pagamento

A integração contempla:

  • Pix à vista;
  • Pix parcelado.

Recursos integrados

Estão disponíveis os seguintes recursos:

  • consulta;
  • transação;
  • estorno.

Callback

O callback da integração é realizado automaticamente pela Uappi.

Não é necessário cadastrar uma URL de callback ou realizar qualquer configuração adicional para o recebimento das atualizações da transação.


Antes de começar

Para configurar a integração, é necessário possuir uma conta na Pagaleve e obter as credenciais que serão utilizadas na Uappi.

Caso ainda não possua acesso:

  1. Acesse o site da Pagaleve e vá até a área destinada a varejistas.
  2. Preencha os dados solicitados para contato.
  3. Aguarde o contato de um especialista da Pagaleve.
  4. Informe que deseja utilizar a Pagaleve integrada à Uappi e que precisa das credenciais necessárias para realizar a configuração.
  5. Após a liberação, os dados de acesso serão fornecidos pela própria Pagaleve.

Importante: tenha as credenciais fornecidas pela Pagaleve em mãos antes de iniciar a configuração na Uappi.


Como acessar a configuração da Pagaleve

No painel administrativo da Uappi, acesse:

Configurações > Pagamento > Gerenciamento

Localize os conectores:

  • Pagaleve Pix à vista
  • Pagaleve Pix Parcelado

As duas modalidades possuem conectores separados e devem ser configuradas individualmente.


Configurando o Pagaleve Pix à vista

Na opção Pagaleve Pix à vista, clique no ícone de edição.

Preencha as credenciais fornecidas pela Pagaleve:

Nome de usuário

Informe o nome de usuário disponibilizado pela Pagaleve.

Senha

Informe a senha correspondente à conta.

Em seguida, localize o campo Parcelamento.

Para utilizar a modalidade Pix à vista, configure:

Parcelamento: Inativo

Importante: o campo Parcelamento pode aparecer inicialmente como Ativo. Para utilização do conector Pagaleve Pix à vista, altere a configuração para Inativo antes de salvar.

Após preencher as informações, clique em Salvar.


Configurando o Pagaleve Pix Parcelado

Para disponibilizar o Pix parcelado, retorne a:

Configurações > Pagamento > Gerenciamento

Localize Pagaleve Pix Parcelado e clique no ícone de edição.

Preencha:

  • Nome de usuário: informe o usuário fornecido pela Pagaleve;
  • Senha: informe a senha correspondente.

No campo Parcelamento, configure:

Parcelamento: Ativo

Depois, clique em Salvar.


Atualização do pedido

Na configuração do conector, está disponível a opção:

Alterar status do pedido quando a transação for cancelada

Essa configuração determina se o status do pedido na Uappi será atualizado após o cancelamento da transação.


Informações do pagamento

A configuração também apresenta campos complementares relacionados ao pagamento.

Descrição que será exibida para o cliente na fatura do cartão (máximo 13 caracteres)

Esse campo faz parte da estrutura de configuração dos gateways WAPI.

Como a Pagaleve utiliza Pix, esse campo não faz parte das configurações principais necessárias para utilização da integração, salvo orientação específica para o projeto.

Observação do pagamento

Permite definir a mensagem utilizada na observação do pagamento.


Vinculando a Pagaleve ao meio de pagamento

Após configurar e salvar o conector, é necessário vinculá-lo ao meio de pagamento que será utilizado no checkout.

Acesse a seção Suas configurações de pagamento e localize a opção correspondente ao Link externo.

Selecione o conector Pagaleve configurado anteriormente e realize o vínculo.

Caso a loja utilize as duas modalidades, realize a configuração correspondente para os conectores:

  • Pagaleve Pix à vista;
  • Pagaleve Pix Parcelado.

Importante: somente preencher as credenciais e salvar o conector não disponibiliza o pagamento no checkout. É necessário realizar também o vínculo com o meio de pagamento correspondente.


Perguntas frequentes

Posso oferecer Pix à vista e Pix parcelado ao mesmo tempo?

Sim. A Uappi possui conectores separados para as duas modalidades.

Para isso, configure individualmente:

  • Pagaleve Pix à vista: Parcelamento Inativo;
  • Pagaleve Pix Parcelado: Parcelamento Ativo.

Depois, realize o vínculo dos conectores com a configuração de pagamento correspondente.

Qual é a diferença entre os dois conectores?

Os conectores representam as modalidades de Pix à vista e Pix parcelado.

Na configuração, confira principalmente o campo Parcelamento:

  • no Pagaleve Pix à vista, mantenha Inativo;
  • no Pagaleve Pix Parcelado, mantenha Ativo.

O campo Parcelamento já aparece como Ativo no Pagaleve Pix à vista. Preciso alterar?

Sim. O campo pode aparecer inicialmente como Ativo, mas para utilização da modalidade Pix à vista deve ser alterado para Inativo.

Após realizar a alteração, clique em Salvar.

Preciso configurar o callback manualmente?

Não. O callback da integração é realizado automaticamente pela Uappi, sem necessidade de cadastrar uma URL manualmente.

Onde consigo as credenciais da Pagaleve?

As credenciais são fornecidas pela própria Pagaleve.

Caso ainda não possua os dados necessários, entre em contato com a empresa e solicite as informações para utilização da integração com a Uappi.

Configurei a Pagaleve, mas a opção não aparece no checkout. O que devo verificar?

Além de preencher as credenciais e salvar o conector, verifique se ele foi vinculado corretamente ao Link externo em Suas configurações de pagamento.

Atualizado em 03/09/2026

Leave a Reply

Your email address will not be published. Required fields are marked *