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.

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:

Leia mais…;

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.

Leia mais…;

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.

Criar uma requisição de pagamento consiste em fazer uma chamada à API de Pagamentos do PagSeguro, informando os dados de uma compra a ser realizada em sua loja. Esses dados da compra podem ser por exemplo os produtos que serão vendidos bem como os dados do comprador que está navegando.

Para informar esses dados, seu sistema deve fazer uma requisição à API de Pagamentos do PagSeguro que irá armazenar os dados e retornar um código de requisição.

Com o código de requisição em mãos, sua loja ou aplicação será capaz de direcionar o comprador ao PagSeguro onde ele realizará o pagamento dos itens previamente informados. Dessa maneira seu sistema irá oferecer maior segurança e flexibilidade, pois os dados do pagamento serão informados via API diretamente pelo seu sistema e não irão trafegar pelo navegador do usuário na internet.

Nesse contexto a classe PaymentRequest da biblioteca é responsável por criar uma requisição de pagamento de maneira prática: você apenas informa os dados do pagamento e logo após executa o método register que lhe devolve a URL necessária para direcionar seu comprador ao ambiente seguro onde ele realizará o pagamento.

Para melhor entendimento, vamos exemplificar a criação de uma requisição de pagamento com o seguinte cenário:

• O comprador navega pela loja e decide comprar um notebook na cor prata no valor de R$ 2.430,00 e uma mochila no valor de R$ 150,99.
• Sua loja requisita os dados do comprador, p.e., nome completo, e-mail e telefone bem como os dados do endereço de envio.
• Ainda na loja o comprador escolhe pagar com PagSeguro.

Com essas informações em mãos você deve criar um objeto do tipo PaymentRequest:

Agora você deve adicionar os produtos ao objeto criado:

Você também pode informar os dados fornecidos pelo comprador em sua loja, assim, o comprador não precisará informar esses dados novamente no site do PagSeguro:

Informe o endereço de envio fornecido pelo comprador, assim, o comprador não precisará informa-lo novamente no site do PagSeguro:

É necessário que você informe a moeda em que o comprador irá realizar o pagamento. No momento, a única opção disponível é BRL (Real).

É necessário informar também o tipo de frete da compra, veja mais detalhes na classe Shipping:

Caso o seu sistema utilize um código de referência para cada compra que é feita em sua loja, você pode utiliza-lo para vincular a uma transação no PagSeguro:

Agora que você informou os dados da compra, você deve executar o método register, que faz a requisição à API de Pagamentos do PagSeguro, retornando a URL necessária para o comprador fazer o pagamento:

Com a URL em mãos você pode direcionar o comprador ao PagSeguro, para que ele faça o pagamento em ambiente seguro (HTTPS). Veja todas as opções da classe PaymentRequest na página de classes da biblioteca.

Obs.: o método register faz uma chamada via API, para isso é necessário informar as credenciais utilizando um objeto do tipoAccountCredentials. Se você deseja utilizar credenciais previamente definidas no arquivo de configurações, veja como utilizar o método getAccountCredentials da classe PagSeguroConfig.

Tem alguma dúvida sobre como integrar o PagSeguro? 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.

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.

Tramita na Câmara Federal para análise dos deputados uma proposta para criação do Código Nacional de Ciência, Tecnologia e Inovação (Projeto de Lei 2177/11). Criado pelo deputado Bruno Araújo (PSDB – PE) com outros nove, o texto prevê facilidades de importação de produtos que facilitem pesquisas brasileiras.

Os principais pontos são: isenção de impostos de importação para materiais de pesquisa; facilitar o acesso à biodiversidade brasileira para pesquisas biológicas; flexibilizar a Lei de Licitações (8.666/93) para as compras e contratações no setor. Além disso, prevê a criação de ambientes cooperativos de pesquisa e de geração de produtos inovadores, flexibilizando a atuação de pesquisadores vinculados a entidades públicas.

Apesar do grande potencial nacional de nossas universidades e de outras entidades publicas e privadas, nosso campo de pesquisa ainda é muito fraco, afirma o deputado Bruno Araújo. O setor não vem cumprindo um “papel relevante no desenvolvimento econômico e social do país (…) Um dos principais entraves é a legislação”.

O código isenta impostos para importação de máquinas, equipamentos, aparelhos, instrumentos, peças de reposição e matérias-primas e outros produtos, desde que destinados à pesquisa científica, tecnológica e de inovação.

Fonte: Agência Câmara de Notícias
Imagem: Tcm/Rio/Gov.

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.