PayPal

O PayPal é um serviço de pagamentos digitais que possibilita a realização de transações financeiras em lojas virtuais e aplicativos, por meio de conta PayPal vinculada a métodos de pagamento cadastrados, conforme disponibilidade do serviço.

Pré-requisitos

• Para usar o PayPal, contrate o serviço diretamente com o PayPal e selecione a Braspag como service provider;
• No PayPal, é possível configurar a captura automática ou a pré-autorização.
• Integre o PayPal à API do Gateway de Pagamento no backend da sua loja. Se desejar, inclua também o botão do PayPal para exibição na página de checkout.

Integrando com o Gateway de Pagamento

Integre os métodos de autorização e captura enviando uma requisição no método POST para a API do Gateway de Pagamento.

Na requisição da transação, informe o campo Provider com o valor "PayPal" e o campo Type com o valor "Wallet".

Incluindo o botão do PayPal

Você pode integrar o botão do PayPal diretamente na página de checkout. Nesse modelo, a integração combina o script do PayPal com a API do Gateway de Pagamento.

Como funciona a integração

Para habilitar o botão do PayPal, adicione um script HTML na página de checkout. Esse script:

• Renderiza o botão do PayPal;
• Expõe duas funções que devem ser implementadas pela sua aplicação.

Funções obrigatórias

Implemente as seguintes funções no script:

• createOrder: executa a autorização da transação. Integre essa função ao backend usando o método de autorização da API do Gateway de Pagamento;

• onApprove: realiza a captura do valor da transação.

Ajustes necessários no script

No código do script:

1. Substitua a URL de demonstração da função onApprove (/demo/checkout/api/paypal/order/) pelo endpoint
   paypal/{transactionId}/manualapprove.
2. Ajuste os demais campos conforme a implementação do seu backend para consumir o método de autorização.

A imagem a seguir apresenta um exemplo de como o código deve ficar após as alterações.

Acesse a página de integrações de botões do PayPal, leia as instruções e copie o script completo para usar na sua integração.