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.

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.

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 o PagSeguro, você pode trabalhar com três tipos de frete: por valor fixo, por peso ou frete adicional com valor fixo.

Você também pode disponibilizar para seus clientes a ferramenta de cálculo de frete, para que saiba exatamente o quanto pagará pelo envio da mercadoria.

Para utilizar um desses tipos de frete, você precisa configurá-lo na página de Frete no Menu Preferências em sua conta.

Além disso, é possível disponibilizar também a forma de envio em sua loja. Seus produtos podem ser enviados apenas por SEDEX ou Encomenda normal (PAC), ou se preferir, você pode utilizar as duas formas de envio e deixar a escolha por parte do comprador.

Frete fixo:

Utilize-o para cobrar sempre o valor de frete especificado. Para mais de um item, o valor fixo do frete será multiplicado pelo número de itens. Esta opção não oferece desconto caso o cliente compre mais de um item.

Frete por peso:

Utilize-o para cobrar o frete de acordo com o peso do produto, com base na tabela dos Correios e no CEP informado pelo cliente. Seu cliente poderá optar por Encomenda econômica (PAC) ou Sedex. O limite estabelecido pelos Correios é de até 30kg ou R$10.000,00.

Atenção: Se o somatório dos pesos dos itens ultrapassar o limite de 30Kg, ou se o valor total ultrapassar R$10.000,00, o frete não será calculado no PagSeguro, e deverá ser cobrado à parte, diretamente com seu cliente.

Frete adicional com valor fixo:

Cobrar o frete do item que tiver o valor mais alto no carrinho e cobrar um valor adicional fixo para cada item extra. Não será cobrado frete algum para itens que tenham frete grátis (nem mesmo o valor extra). Esta opção oferece ao cliente desconto no frete dos itens adicionais.

Obs: Os valores de frete por peso calculados pelo PagSeguro são apenas uma estimativa obtida junto aos Correios e devem ser confirmados no ato da postagem.

Saiba como integrar o frete em sua loja virtual, acesse: http://zip.net/bxcgs5

Algumas vezes, ao implantar o sistema do PagSeguro para realizar suas vendas, aparece a seguinte mensagem:

Por que isso ocorre?

No dia 3 de agosto o PagSeguro lançou as famosas APIs, para auxiliar na integração.

Uma delas é a de pagamento, cuja finalidade é fazer uma integração mais dinâmica e segura. Ao utilizar essa nova API de pagamento, automaticamente seu sistema se programa para aceitar pagamentos somente por ela. É necessário desabilitar essa opção para sanar o problema. Veja abaixo como:

1 – Acesse sua conta do PagSeguro – https://pagseguro.uol.com.br/

Acesse no menu a opção “Integrações”.

Escolha “Pagamentos via API”

Desmarque a opção “Quero receber somente pagamentos via API”.

Será exibida uma caixa de diálogo com a seguinte pergunta: “Deseja desativar a restrição de pagamentos com API?”

Seguindo todos os passos corretamente, será exibida a tela abaixo:

Agora você poderá receber seus pagamentos normalmente, eliminando os possíveis conflitos. Caso tenha alguma dúvida, entre em contato com nossa equipe de desenvolvedores, pelo e-mail desenvolvedores@pagseguro.com.br.

O PagSeguro tem uma novidade muito boa para você desenvolvedor. São as novas APIs de integração do PagSeguro. São três serviços: pagamentos, notificações e consultas. São aplicações que visam oferecer mais flexibilidade aos desenvolvedores e mais segurança aos vendedores.

Elas já possuem tutoriais em nosso Guia de Integração https://pagseguro.uol.com.br/v2/guia-de-integracao/index.html, e já passaram por testes com lojistas e desenvolvedores que aprovaram estas novas APIs. O PagSeguro também oferece o download das bibliotecas nas linguagens PHP, Java e .Net, que estão disponíveis e podem ser utilizadas livremente. “Com o lançamento das APIs, estamos oferecendo aos clientes do PagSeguro uma nova plataforma de integração. Os desenvolvedores passarão a ter muito mais recursos para integrar o PagSeguro aos sistemas dos lojistas”, explica Marden Neubert, Diretor de Pesquisa e Desenvolvimento do PagSeguro.

O PagSeguro busca simplificar o uso da ferramenta, para que a integração se torne melhor, facilitando a programação e atingindo desde o grande empreendedor até o pequeno vendedor, pouco experiente no e-commerce. Caso tenha alguma dúvida e queira mais informações, entre em contato com nossa equipe de desenvolvedores, pelo e-mail desenvolvedores@pagseguro.com.br.

Serviço:
Da argila ao forte: como desenvolver uma loja virtual com PagSeguro
Michael Granados – desenvolvedor na Visie e trabalha com PHP há mais de seis anos. Atualmente, ele trabalha com o UOL para elaborar ferramentas em PHP para PagSeguro. Recentemente foi palestrante do CMSBrasil, BlogCamp e PHP-MG
Dia 30 de janeiro, sábado, das 10h às 13h
Faculdade Impacta Tecnologia Rua Arabé, 71 – Vila Clementino (próx. metrô Santa Cruz)
Contribua com 1kg de alimento não perecível para o CPH Lar Vicentino