O PagSeguro é um intermediador de pagamentos completo e de fácil manuseio, que incentiva os desenvolvedores a aproveitar as funcionalidades. No Guia do Desenvolvedor você encontra cada detalhe necessário para a integração do sistema PagSeguro em seu site de comércio eletrônico com tudo que você precisa para que seu cliente comece a vender na internet, com carrinho próprio, retorno automático, cálculo de frete e criação de botões de doação.

Mantemos com o iMasters um Fórum exclusivo para solucionar questões que aparecem naturalmente no desenvolvimento. E agora, para atender diretamente às suas questões, entre em contato através do e-mail desenvolvedores@pagseguro.com.br. O canal funciona de segunda a sexta, das 9h às 18h, apenas para dúvidas técnicas.

Quando um comprador por algum motivo abandonava a tela de pagamento do PagSeguro, era muito difícil identificá-lo, para que o vendedor pudesse interagir com ele para saber por que abandonou o carrinho. Pensando nisso, o PagSeguro criou a API de Consulta por Transações Abandonadas.

O funcionamento é muito simples:

Sempre que um comprador chega em nossa página de checkout e não finaliza o pagamento, o PagSeguro identifica esse cliente e o separa em uma lista de transações abandonadas. Assim, é possível descobrir quem desistiu de alguma transação no fluxo de pagamento e realizar alguma ação de marketing, algum tratamento em especial, como dar algum desconto, para tentar converter esse cliente ou mesmo efetuar modificações em sua loja e assim torna-la mais atrativa.

A requisição dos dados dessa API é semelhante à API de consulta por intervalo de datas, onde você informa os parâmetros para a busca e o PagSeguro lhe retorna todas as transações abandonadas referentes à esses parâmetros.

Veja abaixo um exemplo de requisição, utilizando método GET para fazer envio dos parâmetros (as linhas foram quebradas para facilitar a leitura).

https://ws.pagseguro.uol.com.br/v2/ transactions/abandoned
?initialDate=2012-02-02T00:00
&finalDate=2012-02-02T00:00
&email=suporte@lojamodelo.com.br
&token=95112EE828D94278BD394E91C4388F20

Além dos parâmetros citados, você poderá especificar o número máximo de resultado por página e o número da página em questão. Acesse a consulta de transações abandonadas no nosso guia de integração.

Exemplo de resposta:

Como resposta o PagSeguro retornar um XML contendo as transações no intervalo solicitado, veja um exemplo do XML gerado abaixo:

Para saber o que significa o parâmetro recebido acesse:

https://pagseguro.uol.com.br/v2/guia-de-integracao/consulta-de-transacoes-abandonadas.html#v2-item-consulta-de-transacoes-abandonadas-parametros-resposta

Tem alguma sugestão, dúvida ou viu algum erro no Guia de Integração? Entre em contato.

Utilizando a API de consulta por intervalo de datas, é possível conciliar todos os status de todas as transações em um determinado período, evitando que o seu sistema fique com algum status de pagamento desatualizado por perder alguma notificação em uma manutenção de programada do servidor.
Para o correto funcionamento, é preciso informar para o PagSeguro com qual e-mail você realizará a pesquisa e o token referente a conta em questão (por questões de segurança, evitando que pessoas não autorizadas consultem as transações da sua conta), e por último a data inicial e final para a consulta.
Enviando esses dados o PagSeguro retornará todas transações desse período.

Veja abaixo um exemplo de requisição, utilizando método GET para fazer envio dos parâmetros (as linhas foram quebradas para facilitar a leitura).

https://ws.pagseguro.uol.com.br/v2/transactions
?initialDate=2011-01-01T00:00
&finalDate=2011-02-28T00:00
&email=suporte@lojamodelo.com.br
&token=95112EE828D94278BD394E91C4388F20

 

Além dos parâmetros citados, você poderá especificar o número máximo de resultado por página e o número da página em questão. Para consultar detalhes sobre todos esses parâmetros acesse: Parâmetros de consulta

Exemplo de resposta

 
Como resposta o PagSeguro retornará um XML contendo as transações no intervalo solicitado, veja um exemplo gerado abaixo:

Para saber o que significam os parâmetros recebidos acesse: Parâmetros de resposta

Tem alguma sugestão, dúvida ou viu algum erro no Guia de Integração? Entre em contato.

A língua utilizada nos parâmetros apresentados na nova API do PagSeguro foi alterada para o inglês, tanto para facilitar a manutenção do código como também pelo inglês se tratar do idioma universal na programação.

Comparativo entre os parâmetros:

Veja abaixo os novos parâmetros criados:

Além dessa alteração, foram criados novos parâmetros que tornam os dados enviados da requisição de compra muito mais detalhados e com isso você pode ter um controle maior de sua base de compradores e até mesmo pensar em estratégias de vendas baseadas na região dos seus clientes.

Tem alguma sugestão ou viu algum erro no Guia de Integração ? Entre em contato.

Esta configuração permite que você receba, na URL de redirecionamento, o código da transação que acaba de ser criada pelo pagamento. Isso pode ser bastante útil, pois permite que você obtenha dados sobre a nova transação enquanto o comprador ainda está interagindo com o fluxo de pagamento.

Com o código da transação, você pode consultar os dados da mesma no PagSeguro e mostrar uma mensagem bem específica para o comprador, indicando as opções de pagamento e frete que ele usou e dando uma estimativa dos prazos de entrega.

Segue abaixo um exemplo de URL de redirecionamento com código de transação. O método utilizado é GET:

http://lojamodelo.com.br/conclusao.html?transaction_id=E884542-81B3-4419-9A75-BCC6FB495EF1

Para habilitar essa funcionalidade, você deve acessar a área de configurações do PagSeguro. Ela também pode ser combinada com o redirecionamento para um endereço dinâmico, como neste exemplo (novamente, o método usado na requisição é GET):

http://lojamodelo.com.br/notebook-prata-conclusao.html ?transaction_id=E884542-81B3-4419-9A75-BCC6FB495EF1

Uma vez que você esteja recebendo os códigos de transação nos redirecionamentos para o seu site, você pode consultar o PagSeguro para obter as informações sobre as transações. Isso deve ser feito usando-se a Consulta de Consulta de Transações por Código.

Tem alguma sugestão ou viu algum erro no Guia de Integração ? Entre em contato.

Esta consulta possibilita o acesso a todos os dados de uma transação a partir do código identificador. Ela é bastante útil quando você habilita o recebimento do código da transação no redirecionamento. Você também pode usá-la para verificar mais detalhes de transações obtidas com a consulta por intervalo de datas.

Para consultar uma transação por código identificador, você deve fazer uma requisição à API de Consulta de Transações, informando o código identificador. Veja abaixo um exemplo de chamada a API, que requer a utilização do protocolo HTTP e o método GET (as linhas foram quebradas para facilitar a leitura).

https://ws.pagseguro.uol.com.br/v2/transactions/9E884542-81B3-4419-9A75-BCC6FB495EF1
?email=suporte@lojamodelo.com.br
&token=95112EE828D94278BD394E91C4388F20

Parâmetros de consulta

Abaixo são descritos os parâmetros usados na consulta a transações por código.

Exemplo de resposta

 A resposta da consulta de transação por código é dada em formato XML, como no exemplo abaixo:

E para consultar quais são os parâmetros de resposta, acesse: http://zip.net/byc6C9

Tem alguma sugestão, dúvida ou viu algum erro no Guia de Integração ? Entre em contato.

Antes de iniciar o fluxo de pagamentos, você pode utilizar o carrinho de compras do PagSeguro. Dessa maneira, você permite que o comprador altere o pedido ou mesmo retorne à sua loja para adicionar mais itens, antes de fechar o pedido e prosseguir com o pagamento. Com o carrinho de compras, os dados do pedido permanecerão na sessão do navegador. Essa solução é ideal para lojas mais simples, que não possuem tal funcionalidade.

O exemplo abaixo mostra um formulário HTML semelhante ao exemplo anterior, porém ilustrando o uso do carrinho de compras:

<!– Declaração do formulário –>
<form target=”pagseguro” method=”post”
action=”https://pagseguro.uol.com.br/v2/checkout/cart.html?action=add”>

<!– Campos obrigatórios –>
<input type=”hidden” name=”receiverEmail” value=”suporte@lojamodelo.com.br”>
<input type=”hidden” name=”currency” value=”BRL”>

<!– Itens do pagamento (ao menos um item é obrigatório) –>
<input type=”hidden” name=”itemId” value=”0001″>
<input type=”hidden” name=”itemDescription” value=”Notebook Prata”>
<input type=”hidden” name=”itemAmount” value=”2430.00″>
<input type=”hidden” name=”itemQuantity” value=”1″>
<input type=”hidden” name=”itemWeight” value=”1000″>

<!– Código de referência do pagamento no seu sistema (opcional) –>
<input type=”hidden” name=”reference” value=”REF1234″>

<!– submit do form (obrigatório) –>
<input type=”image” name=”submit”
src=”https://p.simg.uol.com.br/out/pagseguro/i/botoes/pagamentos/120×53-pagar.gif”
alt=”Pague com PagSeguro”>

</form>

Observe que as informações de frete e os dados do comprador não são necessários. Além disso, você deve informar o endereço da página de carrinho de compras no PagSeguro, adicionando um novo item ao carrinho:

https://pagseguro.uol.com.br/v2/checkout/cart.html?action=add

Ver Carrinho

Você também poderá inserir uma opção “Ver carrinho” na sua loja. Assim, o comprador irá ver os itens que já foram adicionados ao pedido. Copie e cole o código em seu site. Escolha um lugar em sua página onde o comprador o encontre facilmente.

<a  href=”https://pagseguro.uol.com.br/v2/checkout/cart.html?action=view”>
<img src=”https://p.simg.uol.com.br/out/pagseguro/i/botoes/pagamentos/99×61-carrinho-assina.gif” alt=”Ver carrinho”/>
</a>

Se você preferir, utilize as seguintes imagens dos botões criadas pelo PagSeguro:

Tem alguma dúvida sobre como integrar o PagSeguro? Entre em contato.

O que é?

Um dos erros mais comuns que alguns desenvolvedores tem ao integrar o PagSeguro é na validação das informações recebidas no Retorno Automático.

Isso normalmente ocorre quando há uma divergência na codificação de caracteres (encoding, charset) do sistema se comparada à utilizada pelo PagSeguro, no caso ISO-8859-1. Ou seja, é como se o sistema utilizado estivesse preparado para tratar as informações apenas em UTF – 8 e ao receber dados contendo uma codificação diferente, os caracteres aparecem “quebrados”, o que impede a interpretação correta dessas informações.

Veja o exemplo abaixo:

Como a palavra “Cartão de Crédito” possui caracteres especiais, no caso acentos, a informação referente a essa transação não foi validada devido ao erro de encoding.

Como corrigir?

Para corrigir o erro de acentuação, o sistema deverá trabalhar utilizando a mesma codificação utilizada pelo PagSeguro  (ISO-8859-1) ou converter os dados antes da manipulação dessas informações.

Uma forma simples de evitar erros de validação é utilizando a API de Notificações, pois o código enviado para o seu sistema não possui acentuação, o que facilita a integração, gerando mais segurança.

A API de Notificação funciona de forma parecida com o Retorno Automático de Dados, porém a etapa de verificação é realizada por um código que não possui acentuação, evitando o problema acima, além de possuir mais campos referentes à transação. Com isso você terá informações mais detalhadas e precisas sobre a venda de seus produtos.

Veja documentação sobre a API de Notificação.

Com as bibliotecas do PagSeguro, fica muito mais fácil integrar em seu site. Essas bibliotecas estão de acordo com a versão mais atualizada do Guia de Integração do PagSeguro (Versão 2).

Em todas as bibliotecas você encontrará:

- Classes de domínios que representam pagamentos, notificações e transações;

- Criação de checkouts via API;

- Controller para processar notificações de pagamento enviadas pelo PagSeguro;

- Módulo de consulta de transações.

•  Biblioteca PagSeguro em PHP.

• Biblioteca PagSeguro em Java.           

• Biblioteca PagSeguro em .NET.

Tem alguma sugestão ou viu algum erro em nosso Guia? Entre em contato conosco.

Aprenda como utilizar as ferramentas que o PagSeguro oferece para integrar seu sistema da forma mais adequada às suas necessidades.

INTEGRAÇÃO BÁSICA

Você pode integrar o PagSeguro ao seu site mesmo sem ter conhecimentos avançados de programação. Veja como é simples:

 1-    Insira Botões de Pagamento em seu site.

2-    Acompanhe as notificações por e-mail.

3-    “>

3-    Consulte suas transações no extrato de transações.

INTEGRAÇÃO COMPLETA

E para ter acesso a todas as funcionalidades e ter todo o potencial do PagSeguro, veja as nossas tecnologias mais avançadas de integração:

1-    Utilize a API de Pagamentos e configure o redirecionamento no final do fluxo de pagamento.

2-    “>

2-    Acompanhe as notificações usando a API de Notificações.

3-    “>

3-    Consulte seu histórico de transações ou detalhes de uma transação individual.

Obs.: o sistema de versionamento das APIs do PagSeguro foi criado de forma a viabilizar a evolução dos serviços e garantir a compatibilidade com os clientes já integrados. Saiba mais sobre o sistema de versionamento das APIs.