Olá campuseiros! A Campus Party continua com força total em 2012. Nesta quinta-feira às 13h, o diretor da Wikipedia, Kul Wadhwa deu as caras por aqui e falou bastante sobre o poder de colaboração que as pessoas adquirem na internet.

A Wikipedia, a enciclopédia colaborativa online, foi uma das responsáveis para a revolução da informação nesta era digital. Para Wahdwa, é importante continuar e lutar por esta cultura “auto-suficiente”, onde todos compartilham a informação. “Minha geração começou isso, a sua deve lutar para estabelecer isso na cultura e os seu filhos já terão essa cultura intrínseca em suas vidas”.

Wahdwa defende a tecnologia na vida das pessoas cada vez mais cedo. Ele acredita que as crianças terão maior facilidade em aprender com ferramentas como a Wikipedia. Para ele, a tecnologia permite trabalhos em conjunto. Ele deu um exemplo de uma criança indiana e uma americana, que possuem diferentes culturas e visões do mundo. Quanto mais cedo elas consigam trocar experiências conjuntas, mais fácil será o aprendizado delas.

Continue acompanhando o blog do PagSeguro na Campus Party!

Imagem: Campus Party

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 consulta permite obter as transações recebidas por você em um intervalo de datas. Ela pode ser usada periodicamente para verificar se o seu sistema recebeu todas as notificações de transações enviadas pelo PagSeguro, de forma a conciliar as transações armazenadas em seu sistema com o PagSeguro.

Para consultar transações por intervalo de datas, você deve fazer uma requisição à API de Consulta de Transações, informando o intervalo desejado. O PagSeguro irá retornar todas as transações direcionadas para sua conta que foram criadas nesse intervalo. Veja abaixo um exemplo de chamada a essa 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
?initialDate=2011-01-01T00:00
&finalDate=2011-02-28T00:00
&page=1
&maxPageResults=100
&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 intervalo de datas:

Exemplo de resposta

A resposta da consulta de transações por intervalo de datas é dada em formato XML. Nem todos os detalhes das transações são retornados por esta consulta; use a consulta de transações por código para obter mais detalhes, caso necessário. Veja uma resposta no exemplo abaixo:

Tem alguma sugestão ou encontrou 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.

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.