Com o PagSeguro, o vendedor possui alguns métodos para receber as informações referentes às transações ocorridas em sua loja.

São eles:

- API de Notificação

- Retorno Automático de Dados

- Redirecionamento com Código da Transação

O PagSeguro garante o envio de todas as notificações que contém as informações completas das transações, porém mesmo em opções mais completas e automatizas como a API de Notificação e o Retorno Automático, podem aparecer alguns cenários onde não conseguiremos completar o contato com o seu servidor, por exemplo uma instabilidade em sua conexão que pode durar horas.

Em casos como esse, indicamos o uso da API de Consulta por Intervalo de Datas para que seja exibida uma lista das vendas que ocorreram em sua loja durante um período terminado.

Essa lista retornará os Códigos das Transações e através da API de Consulta de Transações por Códigos, serão exibidos todos os detalhes referentes à cada compra pesquisada.

Identificamos que um grande número de vendedores tem configurado em seu sistema apenas o Redirecionamento com Código da Transação. A criação desse método foi pensada na exibição de uma mensagem mais específica para o comprador, indicando as opções de pagamento e frete que ele usou e dando uma estimativa dos prazos de entrega.

Visto que é comprovado que o comprador tem o hábito de fechar o navegador após a informação que compra foi efetuada com sucesso, não recomendamos que o seu servidor dependa exclusivamente do redirecionamento do comprador para o seu site, pois nesses casos o seu servidor não receberá o código da transação.

É muito importante que você utilize as outras ferramentas de recebimento de notificações já citadas em conjunto com o Redirecionamento com Código.

Tem alguma sugestão ou encontrou algum erro no Guia de Integração ? Entre em contato com nosso suporte técnico

Ainda não possui uma conta PagSeguro? Cadastre-se, é grátis:

Temos recebido dúvidas sobre o funcionamento do retorno automático. Neste post, esclarecemos algumas dúvidas e damos algumas dicas que auxiliarão no processo de recebimento das informações das transações.

Após o processo de compra e pagamento, o usuário é enviado de volta a seu site. Para isso, você deve configurar uma URL de retorno.

A URL configurada tem duas funções distintas. São elas: redirecionar o comprador de volta para sua loja após o término da compra na página de checkout do PagSeguro e enviar os dados da transação e alteração de status da transação via POST para o seu servidor.

Se o pagamento entrou em análise ou se o usuário pagou usando boleto bancário, o status será “Em Análise” ou “Aguardando Pagamento”. Nesses casos, quando a transação for confirmada (o que pode acontecer alguns dias depois) a loja receberá outro POST, informando o novo status.

Cada vez que a transação muda de status, um POST é enviado:

1) A transação se inicia quando a sua loja envia ao PagSeguro um POST com os dados do pedido:

2) O PagSeguro envia um POST para a URL de retorno que você configurou, com os dados da transação, acrescido do status.

3) Por segurança, o seu sistema deve confirmar os dados recebidos. Para isso, retorne o POST, acrescido do Token de segurança e o parâmetro “comando” validar (comando=Validar).

O PagSeguro recebe sua confirmação e confere se os dados trocados são válidos. Os valores retornados para essa validação são VERIFICADO ou FALSO. Isso garante a integridade da comunicação do retorno automático.

4) Com a validação do POST, você terá o último status da transação atualizado.

Exemplo de informações que foram enviadas via POST e validadas:

Dicas sobre Retorno Automático:

• O envio do POST é automático ao final da transação e quando ocorre uma alteração no status da transação, ambos em background, abre uma nova sessão no seu site.
• Não é possível imprimir nenhum campo do post no momento do recebimento (echo, print, Response.Write, etc).
• As informações deverão ser salvas em seu banco de dados, arquivo texto ou XML no momento do recebimento.
• É necessário que o site e a URL de Retorno estejam hospedados em um domínio válido.
• Não poderá ser uma aplicação local (você não conseguirá receber os dados em um ambiente local, como “localhost” por exemplo).
• O código de NPI (Notificação de Pagamento Instantâneo) não conseguirá ler valores de Sessions ou Cookies, porque assim que o PagSeguro envia o POST para o seu web site, é aberta uma nova sessão (conforme mencionado acima).
• Não há restrições de saída no PagSeguro, mas caso você não esteja recebendo nenhum dado do PagSeguro, libere em seu firewall os seguintes IP’s de POST do NPI: 200.221.19.20 e IP de Redirecionamento simples: 200.221.19.4.
• Servidor configurado em uma porta da 80 (HTTP) ou 443 (HTTPS).
• A programação do retorno automático deve enviar de volta para o PagSeguro todos os campos recebidos no POST, mais o comando=validar e o token=”Seu Token”.
• Use o token de segurança para validação da transação.
• Retorne os dados para validação sem nenhuma conversão, exatamente da maneira como recebeu (verifique se a sua string está sendo enviada com Encode, por exemplo: “%20” ou o sinal de adição “+” substituindo o espaço, etc).
• É muito importante sempre colocar um debug em seu código, salvando o erro do debug no seu banco de dados para analisar onde e porque ocorreu o erro no momento do retorno.
• O script em nossa página é apenas ilustrativo, cada desenvolvedor altera de acordo com o próprio sistema.

Links úteis:

Defina a URL que receberá as informações das transações: Retorno Automático

Configure o endereço de redirecionamento: Página de Redirecionamento

Crie um Token para sua conta PagSeguro: Token

Observe todos esses itens, e se ainda você não conseguir receber o POST, entre em contato com nosso suporte técnico

Ainda não possui uma conta PagSeguro? Cadastre-se, é grátis:

Muitas pessoas perguntam se é necessário criar uma nova conta no PagSeguro para administrar mais de uma loja virtual, já que no Painel de Controle não é possível configurar mais de uma URL para receber as notificações das transações. Mas isso não impede o vendedor de utilizar a mesma conta para quantos sites quiser. Ele só terá que identificar de qual loja virtual vem cada pagamento.

Ou seja, as informações relacionadas às vendas de todas as suas lojas serão centralizadas num único endereço e após o recebimento desses dados o seu sistema aplica um filtro e consegue identificar a origem de cada venda.

Identificando a transação:         

Se o método de integração utilizado for a API de Notificação, utilize o parâmetro abaixo:

<id>

Para mais informações, basta verificar em nosso guia de integração em API de Notificação

No caso de Retorno Automático:

<ProdID_x>:

Para mais informações, acesse em nosso guia de integração as informações sobre o Retorno Automático

Esses parâmetros são de presença obrigatória em seu código e eles identificam os itens da transação. Nesse campo é possível adicionar uma informação referente ao produto. Por exemplo: 0112

Onde 01 é o número identificador da loja e 12 é o número do produto à ser vendido.

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

Ainda não trabalha com o PagSeguro? Cadastre-se e comece suas vendas:

O PagSeguro quer desejar uma ótima Páscoa a todos nós do e-commerce. A Páscoa é uma data comemorada no cristianismo, que significa a ressurreição de Cristo. No comércio, tem-se a tradição de presentear as pessoas com ovos de páscoa, de chocolate.

A Páscoa representa a passagem do velho para o novo. Aproveite esta data para repensar suas estratégias e melhorar as vendas, focando em novos projetos ou produtos. Desejamos muitas vendas de Ovo de Páscoa, muito chocolate e uma ótima Páscoa a todos!

Imagem: Helen Thorn CC BY 2.0l

A fim de criarmos um padrão para os webservices, todos os parâmetros utilizados nas API’s do PagSeguro estão em Inglês, consequentemente as respostas e erros também ocorrerão em inglês. Mesmo se você não tiver familiaridade com o idioma, não se preocupe, criamos uma tabela informativa para lhe ajudar, mostrando os possíveis erros e como corrigir:

Para visualizar corretamente, basta clicar e dar zoom.

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

Após finalizar a integração, pode ocorrer um problema de acentuação na descrição de seus produtos exibida em nossa página de checkout, podendo causar uma desconfiança e insegurança no comprador, o que pode levá-lo à desistência da compra.

Veja abaixo o exemplo:

Para ilustrar esse problema de uma forma fácil, vamos imaginar duas pessoas onde cada um fala um idioma. Em uma conversa entre eles, algumas palavras não poderão ser compreendidas de forma correta, o que torna esse diálogo aberto a interpretações. Para evitar esse problema eles devem usar o mesmo idioma para se comunicar.

Com o PagSeguro e o seu sistema ocorre algo semelhante. Eles precisam falar um mesmo idioma afim de as informações aparecerem corretamente. Nesse caso, esse mesmo idioma seria o “encoding”, que é conhecido também como a “Codificação de Caracteres”.

O PagSeguro utiliza o encoding ISO-8859-1 para “entender” o que está escrito, alguns sistemas podem utilizar outro encoding e ao enviar essa informação para o PagSeguro irá resultar no erro mostrado na imagem acima.

A boa notícia é que você não precisa mudar todo o seu sistema para que ele “fale outro idioma”, basta informar para o PagSeguro o encoding que seu sistema utiliza usando o parâmetro de nome encoding.

Agora o PagSeguro exibirá toda acentuação da forma correta:

Acesse nosso guia do desenvolvedor e veja um exemplo do uso do Parâmentro Encoding

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

Sempre que cadastrar uma URL para receber notificações de transações ou o retorno automático de dados, devem ser seguidos alguns passos importantes, afim de não ocorrerem problemas no recebimento, ou em alguns casos, não receber a notificação da transação.

Verifique se a URL cadastrada está correta.
Quando se copia e cola uma URL pode faltar algum pedaço do link ou algo semelhante, fazendo com que o PagSeguro envie os dados para o local errado, resultando na perca total de informações.

Utilize portas padrões na sua URL

Sempre que for configurar uma URL, procure utilizar as portas convencionais. Evite utilizar portas especificas para que não ocorram problemas na entrega das informações. Veja um exemplo de URL inválida: http://exemplo.com.br:8585/notificacao. URL válida: http://exemplo.com.br/notificacao

Verifique suas credenciais.

Se você estiver utilizando a API de notificações será necessário informar o e-mail e token para consultar detalhes da transação, verifique se o e-mail foi digitado corretamente, e se o token é o último gerado. Caso não tenha certeza, gere um novo. No caso do retorno automático de dados, você irá precisar do token para fazer a verificação de dados, verifique-o.

O token deve pode ser gerado acessando: https://pagseguro.uol.com.br/integracao/token-de-seguranca.jhtml você dever estar logado na conta PagSeguro para o qual o código será gerado.

Utilize o log para mapear todos os processos.
Como o PagSeguro sempre envia os dados em background, não será possível visualizar nada na tela. Nesse caso a solução é usar logs.
Prefira utilizar log em texto, assim as chances de erro serão menores, uma vez que não irá precisar de um servidor de banco de dados ou algo do tipo.
Fique atento em testar o funcionamento do log antes de testar o recebimento dos dados.

Faça uma coisa de cada vez.
Ao invés de sair criando toda aplicação e só no final ver se tudo está funcionando, construa sua aplicação em etapas, assim ficará mais fácil de saber onde ocorre o erro. Como sugestão, primeiro veja apenas se está recebendo os dados, depois realize o tratamento da informação, assim evitará erros no tratamento e você acreditar que o erro está no não recebimento de dados.

Evite redirecionamentos.
Ao invés de redirecionar para outra pagina, configure na sua conta do PagSeguro uma URL que já irá realizar todo o procedimento. Ao redirecionar e não tomar cuidado correto com os dados pode haver perda de informação na transição de páginas e consequentemente a página de destino não obter a informação necessária.

Notificação de transações, Retorno automático de dados e Página de redirecionamento são coisas diferentes, utilize URLs diferentes.
Tratar todos esses serviços em um único arquivo muitas vezes pode fazer com que uma informação passe por uma instrução diferente da esperada, causando problemas no resultado final da sua lógica. Nesse caso tente evitar usar a mesma URL, para ambos.

Verifique bloqueios no seu servidor
Para que os dados sejam enviados corretamente, é necessário que a URL cadastrada não tenha nenhuma restrição de acesso, o PagSeguro realiza o envio de todas informações via robots, o que alguns servidores podem realizar bloqueios desse tipo.

Se depois de verificar todos esses procedimentos ainda continuar com problemas, entre em contato, que iremos lhe ajudar no que for possível.

Utilizando por base a calculadora de parcelamento do PagSeguro, você poderá reproduzir os mesmos números em seu sistema.

Antes de montar a lógica do calculo utilizado, precisamos primeiro entender que a parcela mínima é de 5 reais, ou seja, não será possível dividir 6 reais em duas vezes, por exemplo.
Outro ponto importante é atentar o número máximo de parcelas para cada bandeira. No caso:12x – Visa

• 12x – MasterCard
• 12x – Diners
• 15x – American Express
• 12x – Hipercard
• 18x – Aura
• 12x – Elo
• 3x – PLENOCard
• 3x – Personal Card

Bom, de posse das regras, apenas para calcular o número de cada parcela, é necessário um fator multiplicador. O PagSeguro disponibilizou o fator multiplicador na última coluna da tabela (veja na tabela abaixo)

Veja que para cada quantidade de parcelas temos um fator diferente. Então para acharmos o valor da parcela se o comprador dividir a transação em 6 vezes por exemplo, você poderá pegar o fator correspondente a 6 parcelas e multiplicar pelo valor total a ser pago.

No exemplo da compra em 6 vezes de um produto que custa R$ 1000.00 pegamos o fator correspondente ao numero de parcelas (no caso 6 parcelas, fator 0,17847)  e multiplicamos pelo valor total (R$ 1000.00), ficaria 1000.00 * 0.17847 = 178.47. Nesse caso o número de cada parcela irá ser de R$ 178.47.

A economia brasileira está indo muito bem nos últimos anos, e a expectativa é de crescimento do PIB em 2012. De acordo com a análise da empresa Economist Intelligence Unit, especializada em serviços de prognóstico e aconselhamento, o PIB brasileiro deverá crescer 3,3% neste ano.

E acompanha a boa fase da economia o e-commerce doméstico. De acordo com um estudo da empresa eMarketer, que faz análise de mercado, estima-se que o comércio eletrônico brasileiro movimente 30 bilhões de reais em 2012, representando um aumento de 21,9% em relação ao ano de 2011.

Os principais fatores para esse aumento, de acordo com o estudo, são a facilidade e a diversidade de meios de pagamento e a segurança contra fraudes. O meio de pagamento mais usado é o cartão de crédito, usado por 63% dos consumidores pesquisados, seguido pelo boleto bancário, com 37%. Com relação a segurança, mais de 70% dos consumidores afirmaram que a segurança aumentou nos últimos dois anos.

Esses são dados muito animadores para o mercado, que está em constante crescimento, recebendo muitos investimentos na mesma proporção que ganha cada vez mais adeptos.

Via: Comunicaweb

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.