Como configurar a integração com o PayPal na Uappi?

O PayPal é uma das soluções de pagamento disponíveis na Uappi e permite oferecer diferentes formas de pagamento aos clientes durante o checkout.

A integração utiliza a estrutura do PayPal Complete Payments (PPCP), solução atual do PayPal para processamento de pagamentos, permitindo trabalhar com experiências como PayPal Wallet e pagamento com cartão por meio do BCDC (Basic Credit and Debit Card).

A disponibilidade das formas de pagamento pode variar conforme a configuração e os recursos habilitados para a conta PayPal.

Como funciona a integração?

A integração permite que a loja utilize diferentes experiências de pagamento disponibilizadas pelo PayPal.

Entre elas estão:

  • PayPal Wallet: permite que o cliente utilize sua conta PayPal e os meios de pagamento disponíveis nela;
  • BCDC (Basic Credit and Debit Card): permite realizar pagamentos com cartão sem que o comprador precise possuir uma conta PayPal;
  • Outros meios disponibilizados pelo PayPal: podem ser utilizados conforme a disponibilidade e habilitação para a conta e para o mercado de atuação.

Wallet e BCDC fazem parte da mesma estrutura de integração do PayPal, mas oferecem experiências diferentes ao consumidor.

Importante: o BCDC não deve ser entendido isoladamente como substituto do PayPal Plus. Ele faz parte do PayPal Complete Payments, estrutura recomendada pelo PayPal para as novas integrações.


PayPal Wallet

No pagamento por PayPal Wallet, o consumidor utiliza sua própria conta PayPal.

Ao selecionar essa opção no checkout, o fluxo de autenticação do PayPal é apresentado para que o cliente faça login e escolha uma das formas de pagamento disponíveis em sua conta.

Após a conclusão do pagamento, o resultado da transação é retornado para a loja.


Pagamento com cartão pelo BCDC

O BCDC (Basic Credit and Debit Card) permite que o consumidor realize o pagamento com cartão sem precisar possuir ou criar uma conta PayPal.

Nesse fluxo, o PayPal é responsável pelo processamento do pagamento e pelas validações necessárias para a transação.

Importante: o BCDC utiliza a experiência disponibilizada pelo próprio PayPal. Ele não deve ser confundido com o ACDC (Advanced Credit and Debit Card), modalidade que permite uma experiência mais personalizada de campos de cartão diretamente no checkout e possui requisitos próprios de habilitação.


Como configurar o PayPal na Uappi?

Para acessar as configurações de pagamento:

  1. no painel Uappi, acesse Configurações > Pagamento > Gerenciamento;
  2. localize o gateway PayPal;
  3. acesse a opção de edição;
  4. informe os dados necessários para a integração;
  5. salve a configuração.

Atenção: os campos apresentados podem variar conforme a modalidade e a configuração utilizada pela loja.


Conexão com o PayPal

A integração precisa estar associada corretamente à conta PayPal responsável pelo recebimento dos pagamentos.

Dependendo do fluxo disponibilizado para a operação, essa conexão pode utilizar um processo de autorização da conta ou credenciais fornecidas pelo PayPal.

Quando forem utilizadas credenciais de API, os principais dados são:

  • Client ID;
  • Secret.

Essas informações identificam a aplicação responsável pela comunicação com o PayPal.


Autorização da conta PayPal

Em operações realizadas por meio de uma plataforma parceira, a conexão da conta pode utilizar o fluxo de autorização disponibilizado pelo PayPal.

Nesse processo, o lojista é direcionado ao ambiente do PayPal para autorizar a integração da conta com a plataforma.

Após a autorização, a conta pode utilizar os recursos disponibilizados conforme sua habilitação.


Como funciona o pagamento?

De forma geral, o processo ocorre da seguinte maneira:

  1. o cliente escolhe uma forma de pagamento PayPal no checkout;
  2. a Uappi inicia a transação;
  3. o PayPal realiza o processamento e as validações necessárias;
  4. a situação do pagamento é retornada para a integração;
  5. o pedido segue o fluxo correspondente ao resultado da transação.

A experiência apresentada ao comprador depende da forma de pagamento escolhida.


Pagamentos pendentes

Em determinadas situações, uma transação pode permanecer temporariamente pendente enquanto o PayPal realiza verificações adicionais.

Isso pode acontecer, por exemplo, durante análises relacionadas à segurança ou ao processamento da transação.

Enquanto o pagamento não possuir uma confirmação definitiva, o pedido não deve ser considerado pago apenas pela criação da transação.

A integração acompanha o resultado do processamento para que o pedido siga o fluxo correspondente ao status retornado pelo PayPal.


Reembolsos

Pagamentos processados pelo PayPal também podem possuir suporte a operações de reembolso, conforme as regras e condições aplicáveis à transação.

O processamento ocorre a partir da transação originalmente capturada pelo PayPal.


E o Pix?

O PayPal Complete Payments também pode disponibilizar outros meios de pagamento conforme a operação, a conta e os recursos habilitados pelo PayPal.

No Brasil, o Pix pode fazer parte das soluções disponibilizadas pelo PayPal. Sua utilização, entretanto, depende da disponibilidade e habilitação desse recurso para a integração.

Por isso, a existência da opção deve ser confirmada para a operação antes de sua utilização.

Importante: a disponibilidade de uma forma de pagamento no PayPal não significa necessariamente que ela esteja habilitada para todas as contas ou configurações da integração Uappi.


PayPal Plus e a nova integração

Lojas que utilizavam integrações anteriores do PayPal podem encontrar referências ao PayPal Plus.

A estrutura atual utiliza o PayPal Complete Payments (PPCP), que reúne diferentes experiências de pagamento, incluindo Wallet e pagamentos com cartão.

O BCDC é uma das modalidades disponíveis dentro dessa estrutura e permite o pagamento com cartão sem exigir uma conta PayPal.

Por isso, BCDC e PayPal Plus não devem ser tratados como exatamente a mesma solução.


Antes de finalizar, confira

Antes de disponibilizar o PayPal no checkout, confirme:

  • se a conta PayPal utilizada pela loja está ativa;
  • se a integração está corretamente configurada na Uappi;
  • se a conta foi corretamente conectada ou autorizada;
  • se as credenciais necessárias foram informadas, quando aplicável;
  • se as formas de pagamento desejadas estão habilitadas para a conta;
  • se a integração foi testada antes da disponibilização em produção;
  • se os pedidos estão recebendo corretamente as atualizações de pagamento.

Perguntas frequentes

O cliente precisa possuir uma conta PayPal?

Depende da forma de pagamento utilizada.

No PayPal Wallet, o consumidor utiliza sua conta PayPal.

Já no pagamento com cartão por meio do BCDC, o consumidor pode realizar o pagamento sem possuir uma conta PayPal.

BCDC e PayPal Wallet são a mesma coisa?

Não.

O Wallet utiliza a conta PayPal do consumidor. O BCDC é voltado ao processamento de pagamentos com cartão sem exigir uma conta PayPal.

Ambos fazem parte da estrutura do PayPal Complete Payments.

BCDC é o novo PayPal Plus?

Não exatamente.

O BCDC é uma das modalidades de pagamento disponíveis dentro do PayPal Complete Payments. A estrutura PPCP é a solução atual recomendada para novas integrações e reúne diferentes experiências de pagamento.

Qual é a diferença entre BCDC e ACDC?

O BCDC oferece uma experiência de pagamento com cartão disponibilizada pelo PayPal.

O ACDC (Advanced Credit and Debit Card) permite uma experiência mais personalizada de cartão no checkout da loja e possui requisitos adicionais de habilitação pelo PayPal.

A disponibilidade dessas modalidades depende da integração e da conta utilizada.

O pagamento pode permanecer pendente?

Sim. Algumas transações podem passar por verificações adicionais do PayPal antes de receber uma situação definitiva.

A integração permite reembolso?

A solução do PayPal possui suporte ao processamento de reembolsos de transações capturadas, conforme as regras aplicáveis ao pagamento.

O Pix está disponível?

A disponibilidade do Pix depende dos recursos habilitados pelo PayPal para a conta e para a integração utilizada. Por isso, a disponibilidade deve ser confirmada para cada operação.

Onde configuro o PayPal na Uappi?

No painel Uappi, acesse:

Configurações > Pagamento > Gerenciamento

Depois, localize o PayPal e acesse sua configuração.

Atualizado em 28/09/2026

Leave a Reply

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