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.

Você sabia que é possível definir permissões a e-mails secundários em seu cadastro no PagSeguro?

Esta é uma funcionalidade criada para você que não quer ou não pode utilizar o e-mail principal em sua conta tanto quanto gostaria. E ainda pode utilizar o e-mail secundário para que outro usuário tenha acesso à sua conta, porém restrito a algumas áreas, basta  personalizar as permissões. Veja como é fácil.

Em seu painel de controle, acesse Preferencias > E-mails> selecione o e-mail e clique em definir permissões. Veja abaixo:

Você pode definir se este e-mail se torna o principal (administração) ou apenas o adicional, tendo funções restritas que são; realizar movimentações financeiras (saques), utilizar o saldo PagSeguro para compras ou transferência entre contas, exportar relatórios e visualização de dados financeiros (ver saldo e extrato de transações). Veja abaixo:

Com esse recurso, você tem mais flexibilidade na hora de manusear sua conta, podendo escolher diferentes funções para e-mails secundários.

É o PagSeguro trazendo a você soluções que facilitam o uso dos nossos serviços.

Uma das vantagens de se utilizar o PagSeguro é que você pode vender seus produtos e serviços sem nem mesmo ter uma loja virtual.
Você pode oferecer todas as opções de pagamento que uma loja possui com o PagSeguro.

Veja como:

1. Insira o e-mail do cliente e as informações da cobrança;

2. O PagSeguro envia um e-mail com instruções de pagamento;

3. O destinatário da cobrança efetua o pagamento;

4. Pronto! O pagamento é creditado em sua conta PagSeguro.
Outros casos em que a cobrança por e-mail pode ser utilizada:
• Abandono de carrinho:
Você também pode usar a cobrança por e-mail para evitar que o comprador tenha que refazer todo o processo de compra em seu site, especialmente nos casos em que o meio de pagamento não aprova o pagamento ou que o comprador deseje alterar o pedido.

• Acertos de débitos entre amigos:
Você também pode enviar cobranças por e-mail para receber pagamentos de amigos com todos os meios de pagamento aceitos em sua conta PagSeguro.

Para enviar uma cobrança por email, clique aqui.

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

“Transação inválida. Sempre inicie transações a partir de sites confiáveis”.

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.

ilustração: Phillipe Martin, em CC

O conceito de SMO foi criado em em 2006, por Rohit Bhargava e, então, tinha cinco regras:

1 – Aumento da “linkabilidade” do seu site. A gente sempre fala aqui: é preciso ter conteúdo linkável, que seja referência em posts, vídeos, tweets, nas outras redes sociais. Conteúdo quente – um blog, por exemplo – ajuda. O ideal é ter sempre mais: estudos do mercado e informações relevantes para seu nicho.

2 – Compartilhamento simples: deixe à disposição do usuário botões de social bookmarking para compartilhar no Orkut, Facebook, Twitter, Delicious, etc.

3 – Corresponder aos links recebidos: verificar quem linkou e linkar de volta a partir do seu conteúdo é uma boa prática que, segundo Rohit, favorece o crescimento de links de entrada.

4 – Ajude o seu conteúdo a “viajar” na internet: mais uma vez, se você tem conteúdo de qualidade compartilhe-o através do Twitter, página do Facebook, canal do YouTube.

5 – Incentive a co-criação de conteúdo: permita a utilização do conteúdo através de canais como o YouTube e feeds RSS para que outros possam usá-lo e gerarem links para seu site.

Regras 6 e7 adicionadas por Jeremiah Owyang Leia mais…;