APIs e Microsserviços

4 set, 2013

Guia de preparação para integração com express checkout do PayPal

Publicidade

Este guia tem como objetivo, demonstrar os passos preparatórios necessários para dar início a integração entre PayPal e o seu sistema.

Developer & Sandbox PayPal

Para criar o ambiente de homologação e efetuar os testes de sua integração é necessário usar uma conta PayPal real para se logar na área de Developers, esse procedimento não tem custos e com isso é possível gerar contas de testes, credenciais de acesso e efetuar transações em homologação. Para criar suas contas em nossa área de testes, ou Sandbox, siga o tutorial Utilizando o novo PayPal Sandbox.

Express Checkout

A PayPal tem como ferramenta mais completa de pagamento a API Express Checkout, com ela é possível fazer pagamentos, pagamentos rápidos via Shortcut, criar assinaturas e pagamentos paralelos.

Segue abaixo o fluxo de pagamento básico do ExpressCheckout:

fluxo express checkout

Tutoriais técnicos

Veja a sua necessidade e baixe a documentação necessária abaixo. Porém é leitura obrigatória é o Guia rápido de integração com Express Checkout que explica algumas coisas específicas para PayPal Brasil, como utilizar somente o tipo de pagamento como SALE, na URL de redirecionamento do comprador ao site de checkout PayPal adicionar o parâmetro “&user_action=commit” para o comprador já confirmar o pagamento, entre outras dicas.

Para ver em mais detalhes os campos e caso opte por usar chave-valor nas suas chamadas utilize a sessão ExpressCheckout desse manual: Guia do desenvolvedor da API NVP.

Para ver em mais detalhes os campos e caso opte por usar envelope SOAP utilize este outro manual: Guia de referência da API

Se os itens a serem vendidos forem bens digitais, temos um guia especifico para esse tipo de integração: Guia de integração com Digital Goods

Para assinaturas e pagamentos recorrentes, siga esse tutorial: Integração com a API de pagamentos recorrentes PayPal

Se houver a necessidade de utilizar serviços mais avançados de nossa API como exibir as opções de Frete dentro do Checkout PayPal, Recorrência, entre outros, utilize nosso guia avançado: Guia avançado de integração com Express Checkout

Guias para nossas outras APIs podem ser encontrados neste link: APIs clássicas PayPal

Certificação de integrações PayPal

Para garantir uma integração bugs e sem problemas futuros, a PayPal desenvolveu um guia a ser seguido para validação da integração entre seu sistema e a PayPal, que pode ser encontrado em: Guia de certificação PayPal

PayPal Source Development Kit (SDK)

Com o objetivo de agilizar o processo de integração e oferecer exemplos práticos, fornecemos diversos SDKs para todas nossas APIs utilizando as principais linguagens tais como Java, PHP, Ruby e .NET. Esses SDKs podem ser obtidos através do link: http://paypal.github.io/

Atenção! No momento a tecnologia REST ainda está em Beta, utilize somente as Classics APIs contidas no GitHub.

Imagens e Logos

A PayPal disponibiliza um repositório de imagens e logos que devem ser utilizados em seu site: Botões e logos PayPal

Acesse este link Models para marcas de aceitação PayPal para ter exemplos de como algumas grandes empresas posicionaram as marcas de aceitação e de pagamento do PayPal. Todos estes logos estão disponíveis nonosso repositório de imagem.

API Explorer

Para um melhor entendimento do funcionamento da comunicação, requisições e repostas de cada API da PayPal, você pode utilizar nosso API explorer onde é possível testar diversas chamadas de nossas APIs.

Instant Payment Notification (IPN)

Sugerimos para todas nossas integrações, que para obter um melhor acompanhamento e controle de todas as transações efetuadas, a implantação de nossa API de notificações instantâneas (IPN): Recebendo notificações de pagamento instantâneo

PayPal Notifications

A PayPal oferece um serviço para acompanhamento de todas as atualizações, manutenções em nossa infra ou indisponibilidades. Visando tanto as equipes de infra de nossos parceiros como preparar as integrações ativas com PayPal. O cadastro não tem custo e pode ser feito a qualquer instante em: https://www.paypal-notify.com/main_home

Mais dicas

Demais dicas podem ser encontradas nas páginas para desenvolvedores PayPal, em: www.paypal-brasil.com.br/x/ e https://www.x.com/developers/paypal