PayPal

Ampliar

Comece com o PayPal#

Esta página fornece um guia completo para integrar com sucesso o Paypal com DEUNA.

PayPal é uma plataforma de pagamento digital reconhecida mundialmente que oferece uma maneira segura e conveniente para clientes e comerciantes efetuarem e receberem pagamentos eletrônicos.

Como funciona#

Existem dois tipos de processos de pagamento no PayPal que você pode escolher dependendo de suas necessidades:

Check-out do PayPal

Experiência de pagamento único que oferece mais controle sobre todo o processo de finalização da compra.

• Ele oferece um fluxo de checkout simplificado que mantém os clientes locais em seu site durante o processo de autorização de pagamento.
• O Checkout não oferece a capacidade de armazenar a conta PayPal de um cliente.
• O checkout ocorre apenas para usuários não autenticados ou novos e, portanto, por não possuírem identidade existente, ainda não têm a possibilidade de selecionar parcelas de pagamento.

Cofre do PayPal

Esse fluxo permite que você faça cobranças na conta no futuro sem exigir que o cliente esteja presente durante a transação ou se autentique novamente com o PayPal quando estiver presente durante a transação.

• O PayPal Vault está disponível apenas para usuários autenticados.
• O Vault tem a capacidade de selecionar parcelas de pagamento.

Requisitos#

O conteúdo a seguir lista todos os requisitos para uma integração bem-sucedida com o PayPal.

• Ambientes:
  • Caixa de areia: https://api.sandbox.deuna.io
  • Produção: https://api.deuna.io
• Coleção Carteiro:
  https://www.postman.com/deunaonline/workspace/deuna/folder/30572503-42f68d9b-0763-4002-ba5f-7d1168462e59?action=share&source=copy-link&creator=36841419&ctx=documentation

Etapas de integração#

Agora que os requisitos técnicos estão definidos, você pode iniciar a integração.

1. Configure o processador de pagamento

1. Adicione a carteira do PayPal ao seu Conexões de administrador DEUNA.
2. Procure por “Carteira PayPal” e insira as credenciais da sua conta comercial do PayPal.

2. Botão Pague agora

• Esta opção é controlada diretamente no DEUNA Admin, nas configurações do método de pagamento PayPal do seu comerciante.

• Padrão: CONTINUAR — ativado por padrão para todos os comerciantes (você não precisa realizar nenhuma ação).

• Os comerciantes podem ativar o “Pague Agora” a qualquer momento diretamente do Admin, sem necessidade de uma nova integração técnica.

• A alteração pode ser revertida sempre que necessário – esta não é uma decisão única tomada durante a integração, mas uma alternância dos controles do comerciante de forma independente.

  Como escolher a opção certa

• A principal pergunta a fazer é: Depois que o comprador aprovar o pagamento no PayPal, o valor final já estará bloqueado, sem nenhuma tela de revisão adicional no meu site antes da cobrança?

• Se a resposta for sim → use PAGUE AGORA.

• Se a resposta for não (o comprador ainda pode alterar itens, endereço, frete, complementos ou ver uma tela de confirmação final) → use a opção padrão (você não precisa realizar nenhuma ação).

  Quando usar PAGUE AGORA

• Recomendado para fluxos transacionais, onde o preço já está bloqueado no momento em que o comprador é redirecionado para o PayPal:

  • Compra direta/"Compre agora" na página de um produto, sem carrinho ou etapa adicional de revisão.

  • Bilhetes ou reservas com preço final fixo no momento da seleção - ou seja, nenhuma seleção de assento, bagagem ou upgrades após o retorno do PayPal.

  • Assinaturas e pagamentos recorrentes com valor fixo e imutável.

  • Checkout expresso/com um clique, onde cada etapa extra aumenta o abandono.

  • Bens digitais (aplicativos, jogos, conteúdo), onde o comprador espera “pago = entregue” instantaneamente.

    Quando usar CONTINUE (padrão)

  • Recomendado quando ainda há uma etapa de confirmação ou revisão no site do comerciante após retornar do PayPal:

    • Carrinho com vários itens, onde o comprador pode adicionar produtos, aplicar um cupom ou revisar o frete antes de confirmar.
    • Fluxos onde o frete ou impostos só são calculados após aprovação (ex.: dependendo do endereço de entrega).
    • Reservas com opções adicionais após aprovação, como seleção de assentos ou upgrades, antes da captura final.

3. Crie um pedido

Para fazer uma compra, você deve primeiro criar um pedido DEUNA.

Siga os passos para Crie um pedido.

A API retornará um order_token que é usado em todo o fluxo.

Campos obrigatórios:

Considerações:

• Sobre order.items:
  • total_amount.original_amount deve ser unit_price.amount * quantity.
  • total_amount.amount deve ser ((unit_price.amount + tax_amount.amount) * quantity) - total_amount.total_discount.
  • total_amount.total_discount é o valor total dos descontos pela quantidade de itens.
• order.items_total_amount é a soma dos preços unitários dos itens, esse valor somado ao order.total_tax_amount e menos order.discount_amount deve combinar com o order.total_amount.
• order.sub_total é a soma do preço unitário dos itens menos os descontos, esse valor somado ao order.total_tax_amount deve corresponder ao order.total_amount.

4. Escolha o tipo de integração

Após criar um pedido, escolha o tipo de integração que melhor atende às suas necessidades:

5. Integre o FraudNet

Fraudnet é uma biblioteca desenvolvida pelo PayPal que analisa os dados enviados pelo navegador durante todo o processo de compra para evitar possíveis fraudes nas transações realizadas.

O Fraudnet deve estar em execução durante todo o processo de transação. Para sua integração, o PayPal fornece a seguinte documentação: Integre o FraudNet

6. Valide pagamentos

Valide os pagamentos e certifique-se de usar as regras do PayPal corretamente.

Valores de desconto

Os descontos no PayPal são suportados no nível do pedido. No payload, você deve processar qualquer desconto através do discount_amount field.