PayPal através de widget

Esta página inclui os passos necessários para integrar o PayPal usando o DEUNA Widget.

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.

Exemplo interativoUsa dados de exemplo e não faz solicitações à API.

ProduçãoAmpliar

Pagamentos

Conexões

Descubra e gerencie integrações de pagamento, carteiras e antifraude.

Acme LATAM · Produção

Todas as conexõesAtivasDescobrir

Pesquisar conexõesLimpar

5 conexões de exemploAtualizado agora

Conexões	Tipo	Status	Ação
Adyen	Gateway de pagamento	Conectada	Desconectar
Worldpay	Gateway de pagamento	Conectada	Desconectar
PayPal	Forma de pagamento	Conectada	Desconectar
Mercado Pago	Forma de pagamento	Não conectada	Conectar
Riskified	Mecanismo antifraude	Não conectada	Conectar

2. 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.

3. Criar usuário (opcional)

Crie um usuário com DEUNA para obter o token de autorização para realizar a compra posteriormente. Esta API retornará o nome de um usuário token que será necessário para seguir os próximos passos.

Para criar um usuário, siga o Referência da API. Caso o email utilizado já exista, a API retornará a mensagem user already exists, para que você possa prosseguir para Solicite o OTP e então, Faça login com o OTP para obter um novo usuário token e prossiga com a compra.

Pagamentos de widget#

O widget DEUNA permite dois processos de pagamento para o widget PayPal na DEUNA, que estão documentados neste guia. Cada processo é iniciado dependendo dos atributos do usuário que realiza a compra.

• Processo expresso: Conclui o pagamento no menor tempo possível.
• Processo geral: Permite diferentes métodos de pagamento.

Expresso#

O fluxo expresso é inicializado quando o widget detecta uma experiência de método de pagamento único. Esse fluxo permite que o usuário conclua seu pagamento no menor tempo possível.

Assim que o usuário der consentimento para salvar sua conta PayPal, o pagamento será feito automaticamente e com um único clique.

Ampliar

Usuário novo ou convidado com vault desativado

O fluxo de convidados é definido para novos usuários, usuários cadastrados que não estão autenticados ou quando o estabelecimento comercial desativou o recurso Vaulting. Neste caso, é inicializado o processo de pagamento do checkout, onde o usuário entrará em sua conta PayPal para efetuar o pagamento, mas o mesmo não será salvo.

Se o usuário for novo, seus dados são cadastrados para que ele possa se autenticar para uma compra futura e salvar sua conta PayPal para pagamentos futuros.

Ampliar

Usuário autenticado sem conta PayPal salva

Se o usuário estiver logado, mas não tiver uma conta do PayPal salva, o processo de pagamento por cofre será iniciado e o usuário será redirecionado ao site do PayPal, onde efetuará o pagamento e dará seu consentimento para salvar sua conta e utilizá-la em compras futuras.

Usuário autenticado com conta PayPal salva

Se o usuário estiver autenticado e já tiver uma conta PayPal salva, o pagamento será processado imediatamente porque ele deu previamente o seu consentimento.

Ampliar

Geral#

O fluxo geral é ativado quando o widget detecta uma experiência com vários métodos de pagamento.

O usuário terá um papel maior porque poderá gerenciar suas contas, ou seja, poderá adicionar várias contas ou excluir uma que não utiliza mais.

Os usuários autenticados também têm a possibilidade de selecionar parcelamentos de pagamento dependendo se o estabelecimento comercial exige ou permite.

Usuário novo ou convidado com vault desativado

Quando o usuário é um usuário não autenticado/novo ou o comerciante desativou o recurso Vaulting:

1. O usuário clica no botão PayPal
2. O processo de pagamento da finalização da compra é iniciado
3. O usuário deverá se autenticar no PayPal e efetuar o pagamento.

Neste processo, a conta não é guardada porque não existe uma identificação prévia do utilizador, e os seus dados já estarão registados (caso sejam novos) para que numa futura compra tenha a possibilidade de se autenticar e dar consentimento para guardar a sua conta PayPal.

Ampliar

Exemplo de compra

Aqui está um exemplo de um usuário que faz uma compra com PayPal na DEUNA:

Ampliar

Usuário autenticado sem contas PayPal salvas

Quando o usuário estiver autenticado e não tiver contas salvas:

1. O processo de pagamento por cofre é iniciado e o usuário é redirecionado para o PayPal.
2. O usuário efetua o pagamento no site do PayPal.
3. O usuário dá seu consentimento para salvar sua conta e/ou utilizá-la para transações futuras.

Caso o estabelecimento comercial exija o parcelamento do pagamento, o usuário deverá selecioná-lo após autorizar o pagamento no PayPal.

Usuário autenticado com contas PayPal salvas

Se o usuário estiver logado e tiver salvo contas do PayPal, ele poderá selecionar qualquer conta para efetuar o pagamento. O usuário também pode excluir qualquer conta ou salvar uma nova.

Caso o lojista ofereça pagamento parcelado, estes serão exibidos com a conta selecionada para pagamento e caso o usuário queira utilizar uma nova conta PayPal deverá selecionar o parcelamento após autorizar o pagamento no PayPal.

Visualização de conta única

Este é um exemplo de usuário com uma única conta PayPal na DEUNA:

Ampliar

Visualização de múltiplas contas

Este é um exemplo de usuário com múltiplas contas PayPal na DEUNA:

Ampliar

Exemplo de compra

Este é um exemplo de um usuário que faz uma compra com PayPal na DEUNA:

Ampliar

Falha na transação do PayPal com Vaulting

Quando um pedido do PayPal é rejeitado durante o fluxo do Vaulting, removemos automaticamente o token do PayPal associado à conta usada na tentativa fracassada.

Isto evita futuras transações com a conta inválida. Em seguida, o widget reinicia o processo do PayPal para que o usuário possa autenticar novamente e vincular uma nova conta válida do PayPal para concluir o pagamento.

Ampliar

Valores de desconto

Os descontos no PayPal são suportados no nível do pedido. Na carga útil, você deve processar qualquer desconto por meio discount_amount.