Tutorial: Retorno Automático

Nosso leitor Paulo Santana pediu mais informações sobre o Retorno Automático PagSeguro. Lá no Fórum do i-Masters, temos uma categoria só para ajudar os nossos clientes e parceiros.

Vamos transcrever aqui o tutorial:

A URL de retorno tem duas funções distintas. Uma é redirecionar o usuário após terminar a transação no PagSeguro para o site da loja, apenas redirecionando à página, sem nenhum dado de POST. A outra é enviar os dados da transação e alteração de status da transação via POST.

O POST é automático, enviado ao final da transação e quando ocorre alteração do status, ambos em background, abrindo uma nova sessão no seu web site. Não é possível a exibição imediata no seu web site dos dados do post (echo, print, Response.Write, etc).

Alguns desenvolvedores enfrentam situações em que não conseguem receber o POST. Seguem abaixo os principais motivos e dicas para resolução do problema:

– É necessário que o website e a URL de retorno estejam hospedados em um domínio válido.

– Não poderá ser uma aplicação local (você nunca 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, verifique no seu firewall a liberação do IP 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).

– Não é possível imprimir nenhum campo do post no momento do recebimento do mesmo (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.

– 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.

– Observe todos esses itens, e se ainda você não conseguir receber o POST, entre em contato com nosso suporte técnico, clicando em Atendimento após logar em conta PagSeguro.

Bons negócios!

(e venha para o fórum, saber mais sobre o sistema do PagSeguro)

p.s. tem mais dicas no site da Visie:

Como funciona:http://visie.com.br/pagseguro/retorno-automatico.php

Capturar o retorno automático do PagSeguro, usando a biblioteca: http://visie.com.br/pagseguro/retorno-automatico-php.php

PagSeguro, a forma mais completa de vender dentro e fora da internet