O documento fornece instruções sobre como integrar o Express Checkout da PayPal em aplicações web. Explica os principais métodos da API como SetEC para definir o checkout, GetEC para obter detalhes da transação e DoEC para executar a transação. Também fornece links para documentação, SDKs e tutoriais para ajudar na integração.

1. Express Checkout
Jefferson Prestes
Arquiteto de aplicações web

2. About me
Sou um desenvolvedor de software, apaixonado por desenvolver programas, com experiência em Arquitetura e
Integração de Software de uma ampla variedade de aplicações de negócios.
Particularmente, me interesso em web, web móvel e de desenvolvimento de software cliente / servidor usando
Java, JavaScript, HTML e PHP. Tenho experiência com Oracle PL / SQL, MySQL e PostgreSQL.
Foi engenheiro de integração da PayPal Brasil por 2 anos e antes teve experiências em empresas como JBoss,
RedHat e Editora Abril.
Também sou empreendedor e tenho uma pequena empresa.

3. O que é
Express Checkout ?
• Maior plataforma de pagamento online do mundo
• Permite pagamentos via web e celular
• Além de vendas a vista permite receber parcelamento e assinaturas

4. Sandbox
• Cópia do ambiente de produção. Afinal, como você poderia deixar seus testes
automatizados?
• Para acessar precisa de uma conta PayPal. Ainda não tem? Crie agora:
• https://www.paypal.com/br/cgi-bin/webscr?cmd=_registration-run
• Se já tem a conta acesse developer.paypal.com e se logue.
• No menu principal, clique em Applications
• No menu lateral, clique em Sandbox Accounts
• Na tela que abriu, clique no botão azul Create Account
• Apenas lembre-se de selecionar Brazil no campo country e escolher o tipo
Personal para contas de clientes e Business para contas de vendedores.

5. Obtendo as
credenciais
Sandbox
Assim que terminar de preencher o formulário, você verá uma tabela com sua nova
conta de teste. Se você tiver criado uma conta Business para vendedor, você pode
clicar na conta que aparece na listagem e, depois, no link Profile. Uma janela como a
abaixo irá se abrir:

7. SetEC
• Define o checkout, ou seja, quem vai receber por que itens.
• Gera o Token, a chave temporária do pagamento (cuidado, ele expira em 3
horas !)
• Você pode customizar a imagem do cabeçalho do pagamento, a moeda e a
língua do Checkout

8. GetEC
• Obtem os detalhes da transação
• O que foi vendido e o status da sessão do pagamento
• Também contém os dados do comprador.
• Ele pode ser chamado quantas vezes quiser enquanto o token estiver válido

9. DoEC
• Efetivamente executa a transação
• Trate os erros e os status de pagamento. Ser preguiçoso aqui significa na
melhor hipótese perder dinheiro
• ~99% as resposta é retornada em 5 segundos
• Dinheiro transferido a conta PayPal do vendedor automaticamente
• Não confundir ACK com o payment_status

10. Trate os erros!
Erros mais comuns:
• 10001 – Internal Error: tente chamar novamente
• 10002 – Problemas com a conta ou com as credenciais
• 10417 ou 10486 – Problemas com o cartão de credito do cliente. Redirecione-o
novamente para PayPal para escolher outro instrumento de pagamento.
• A tabela completa esta em:
https://developer.paypal.com/docs/classic/api/errorcodes

11. Quer testar ?
O DevTools é uma ferramenta interativa de testes para você usar para simular as
chamadas de um jeito rápido e simples.
https://devtools-paypal.com/guide/expresscheckout?interactive=ON&env=sandbox

12. Indo para produção
(esta quase lá, não cometa erros aqui)
• Após testar, remova a palavra sandbox de todas as URLs
• Endpoints das APIs:
• https://api-3t.paypal.com/nvp - Produção
• https://api-3t.sandbox.paypal.com/nvp - Sandbox
• Para gerar credenciais em produção siga esse tutorial: https://www.paypal-brasil.
com.br/desenvolvedores/tutorial/criando-e-gerenciando-as-credenciais-da-
api/
• Mude as credenciais para o de seu cliente/empresa
• Peça para ele validar o email da conta. Sem isso não conseguirá receber
pagamentos.

13. Saber mais…
SDKs e Tutoriais
http://paypal.github.io/sdk/
https://github.com/paypal/
https://www.paypal-brasil.com.br/desenvolvedores/tutorial/tutorial-rapido-de-integracao-
com-express-checkout/
https://developer.paypal.com/webapps/developer/docs/classic/api/#merchant

14. Listo!
Agora só receber 
• Startups que façam parte de encubadoras ou aceleradoras podem ter preços
especiais. Procure um gerente de contas em: comercial@paypal.com
• Suporte ao desenvolvedor em português em www.paypal-brasil.
com.br/desenvolvedores
• Participe dos foruns e ajude outros desenvolvedores