GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 1 Guia de Integração Web2App Aplicativo PagSeguro
GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 2 Histórico de Alterações Date Description 28/06/2014 Visão geral 30/06/2014 Revisão Copyright Todos os direitos reservados. O UOL é uma marca comercial do UNIVERSO ONLINE S / A. O logo tipo do UOL é uma marca comercial do UNIVERSO ONLINE S / A. Outras marcas, nomes, logotipos e marcas são de propriedade de seus respectivos proprietários. As informações contidas neste documento pertencem ao UNIVERSO ONLINE S/A. Todos os direitos reservados. UNIVERSO ONLINE S/A. - Av. Faria Lima, 1384, 6º andar, São Paulo / SP, CEP 01452-002, Brasil. O serviço PagSeguro não é, nem pretende ser comparável a serviços financeiros oferecidos por instituições financeiras ou administradoras de cartões de crédito, consistindo apenas de uma forma de facilitar e monitorar a execução das transações de comércio electrónico através da gestão de pagamentos. Qualquer transação efetuada através do PagSeguro está sujeita e deve estar em conformidade com as leis da República Federativa do Brasil. Aconselhamos que você leia os termos e condições cuidadosamente. Aviso Legal O UOL não oferece garantias de qualquer tipo (expressas, implícitas ou estatutárias) com relação às informações nele contidas. O UOL não assume nenhuma responsabilidade por perdas e danos (diretos ou indiretos), causados por erros ou omissões, ou resultantes da utilização deste documento ou a informação contida neste documento ou resultantes da aplicação ou uso do produto ou serviço aqui descrito. O UOL reserva o direito de fazer qualquer tipo de alterações a quaisquer informações aqui contidas sem aviso prévio.
GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 3 Índice Histórico de Alterações... 2 Copyright... 2 Aviso Legal... 2 Índice... 3 Introdução... 4 Utilização Básica... 4 Integração... 4 Solicitação da Venda... 4 Tratamento da resposta da solicitação de venda... 6 Verificando se o app do PagSeguro está instalado... 7 Códigos de Erros... 8
GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 4 Introdução Este documento descreve o processo de integração com o Aplicativo PagSeguro para Android. A funcionalidade Web2App permite que aplicativos de terceiros utilizem o aplicativo do PagSeguro para realizar cobrança de valores. As seções seguintes indicarão como é possível integrar seu aplicativo de pagamentos ao aplicativo do PagSeguro. Utilização Básica A integração com o aplicativo do PagSeguro é realizada através de um link no aplicativo web origem para o aplicativo PagSeguro, onde os dados de cobrança são enviados através de parâmetros GET juntamente com uma Url de retorno. O aplicativo do PagSeguro por sua vez é aberto e o fluxo normal de venda é iniciado. Ao final do processamento da transação o aplicativo do PagSeguro abre o navegador do dispositivo redirecionando para Url de retorno recebida e repassando os resultados em parâmetros GET, para que o aplicativo web possa informar ao seu usuário sobre o resultado da operação. A utilização dessa funcionalidade consiste na criação do código para o envio da solicitação de transação e tratamento da resposta do aplicativo do PagSeguro. Integração Para fazer essa integração, você precisa seguir os seguintes passos: Escrever o código para solicitar a venda através do aplicativo do PagSeguro Escrever o código para tratar a resposta da solicitação de venda Solicitação da Venda Para realizar o envio da solicitação da transação, deve ser realizada uma chamada para a url abaixo, passando como parâmetro GET os dados obrigatórios para processamento do pagamento conforme abaixo: 1. <a href= https://pagseguro.uol.com.br/venda-pelocelular/integracao/mpayment?senderid=aplicacaoweb&returnurl=http://minhaurlder etorno&reference=r1234&amount=5.34 >Pagar</a>
GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 5 PARÂMETRO DESCRIÇÃO Valor da transação que deve ser realizada. Caso não seja informado, o valor será solicitado pelo aplicativo do PagSeguro. amount Presença: Opcional Tipo: Número Exemplo: 5.32 Nome de identificação da aplicação solicitante. senderid returnurl Presença: Obrigatório Exemplo: Nome Da Aplicação Url de retorno para a qual o aplicativo deve redirecionar o resultado do processamento da transação Presença: Obrigatório Exemplo: http://minhaurlderetorno/resultado Código de referência da transação. reference Presença: Opcional Observação 1. Caso necessite passar outros parâmetros que devem ser mantidos na Url de retorno basta adicioná-los normalmente no link de solicitação de pagamento. 2. No momento da primeira solicitação de pagamento o Android irá solicitar que o usuário escolha qual aplicação deverá tratar o pedido de pagamento, o aplicativo PagSeguro ou um dos Browser instalados no aparelho. O usuário deve marcar a opção Sempre e selecionar o aplicativo PagSeguro para que sua escolha seja salva evitando que essa escolha tenha que ser realizada novamente. 3. Caso o aplicativo PagSeguro seja atualizado pode ser necessário realizar o procedimento descrito no item 2 novamente.
GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 6 Tratamento da resposta da solicitação de venda Para realizar o tratamento da resposta à uma solicitação de venda deve ser implementado um código que valide os parâmetros GET recebidos na URL de retorno. Segue abaixo um código de exemplo. 1. <script> 2. parsequerystring = function() { 3. var str = window.location.search; 4. var objurl = {}; 5. str.replace( 6. new RegExp( "([^?=&]+)(=([^&]*))?", "g" ), 7. function( $0, $1, $2, $3 ){ 8. objurl[ $1 ] = $3; 9. } 10. ); 11. return objurl; 12. }; 13. 14. //Example how to use it: 15. var params = parsequerystring(); 16. var errorcode = params["errorcode"] 17. var error = params["error"] 18. var paymentid = params["paymentid"] 19. var paymentstatus = params["paymentstatus"] 20. var paymentreference = params["reference"] 21. 22. if (paymentstatus == 0) { 23. // Pagamento não realizado 24. if (errorcode) { 25. // Ocorreu um erro e aqui deve ser feito o tratamento 26. alert(errorcode + " - " + decodeuri(error)); 27. } else { 28. // Outro tipo de erro ocorreu e deve ser tratado aqui 29. alert('erro não identificado') 30. } 31. } else if (paymentstatus == 1) { 32. // Pagamento realizado com sucesso tratar aqui 33. alert(paymentid + " - " + paymentreference); 34. } 35. </script>
GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 7 Veja abaixo a listagem de parâmetros: PARÂMETRO DESCRIÇÃO errorcode error paymentid Código de erro ocorrido, para que a mensagem possa ser customizada pelo desenvolvedor. Tipo: int Exemplo: 1001 Mensagem de erro. Exemplo: Valor para cobrança abaixo do valor mínimo (R$ 1,00) Código da transação. Exemplo: EB636339-F853-4E39-B627-573395EC2BE9 Informa se o pagamento foi realizado com sucesso paymentstatus Tipo: Número Valores: 1 Pagamento efetuado 0 Pagamento não efetuado Código de referência da transação. reference Presença: Opcional Observação Os parâmetros extras passados na Url de solicitação de pagamento poderão ser extraídos da mesma forma que os parâmetros citados acima. Verificando se o app do PagSeguro está instalado Caso o usuário não possua o aplicativo PagSeguro instalado, ao realizar uma solicitação de pagamento ele visualizará no próprio browser uma tela informando que o aplicativo não está instalado. Nesta tela ele poderá encontrar um link para realizar a instalação do aplicativo antes de prosseguir.
GUIA DE INTEGRAÇÃO WEB2APP APLICATIVO PAGSEGURO 8 Códigos de Erros Veja abaixo os possíveis erros retornados: ERROR CODE DESCRIPTION 1001 Valor para cobrança abaixo do valor mínimo (R$ 1,00). 1002 Usuário não está logado no aplicativo do PagSeguro. 1003 Solicitação de pagamento cancelada pelo usuário. 1004 1005 1006 Não foi possível recuperar o nome do pacote do aplicativo de origem. Utilize a flag FLAG_APP_SENDER ao enviar a solicitação. Erro durante o processamento da transação. É recomendado que não personalize as mensagens de erro desse código. A Url de retorno não foi informada. Utilize o parâmentro GET returnurl para infomá-la 2000 Erro desconhecido.