RETORNO AUTOMÁTICO DE DADOS

Mensagem:
  • Veja a nova API de Notificações do PagSeguro.
  • O PagSeguro criou uma nova API de Notificações: mais completa e mais fácil de usar. Conheça!

Como funciona o Retorno Automático de Dados

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.

Antes de enviar o usuário para essa URL, o robô do PagSeguro faz um POST para ela, em segundo plano, com os dados e status da transação. Lendo esse POST, você pode obter o status do pedido. 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

Retorno Automático

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.

Como programar o Retorno Automático de Dados

Gere os códigos para implantação do Retorno Automático de Dados. (Requer conhecimento avançado de programação)

/codigos_de_retorno_automatico.jhtml

Para mais informações sobre os campos enviados ao seu site, consulte a tabela abaixo:

NOME TIPO TAMANHO DO CAMPO DESCRIÇÃO
VendedorEmail Alfa-Numérico 255 Seu e-mail
TransacaoID Alfa-Numérico 32 Identificação da Transação
Referencia Alfa-Numérico 255 Número de referência gerado por você e enviado ao PagSeguro para identificação em seu site.
Extras Decimal 10,2 Valor de taxas extras.
Formato: 0,00
TipoFrete Alfa-Numérico 2 Tipo de frete pago pelo cliente. Pode receber as seguintes variáveis:
SD - Sedex
EN - Encomenda econômica (PAC)
ValorFrete Decimal 10,2 Valor total do frete pago pelo cliente.
Formato:
  0,00
Anotacao Alfa-Numérico 250 Anotação enviada pelo cliente
DataTransacao Data/Hora - Data e hora da transação.
Formato:
  dd/mm/yyyy hh:mm:ss
TipoPagamento Alfa-Numérico 30 Tipo de pagamento efetuado pelo cliente. Pode receber as seguintes variáveis:
  Pagamento: Pagamento PagSeguro
  Cartão de Crédito: Pagamento via cartão de crédito
  Boleto: Pagamento via boleto bancário
  Pagamento Online: Pagamento via transferência online
Obs.: No caso de doação, o tipo de pagamento será um dos informados acima, e um produto com o nome Doação será enviado neste formulário.
StatusTransacao Alfa-Numérico 30 Status da transação efetuada. Pode receber as seguintes variáveis:
  Completo: Pagamento completo
  Aguardando Pagto: Aguardando pagamento do cliente
  Aprovado: Pagamento aprovado, aguardando compensação
  Em Análise: Pagamento aprovado, em análise pelo PagSeguro
  Cancelado: Pagamento cancelado pelo PagSeguro
CliNome Alfa-Numérico 100 Nome do cliente
CliEmail Alfa-Numérico 255 E-mail do cliente
CliEndereco Alfa-Numérico 200 Endereço do cliente
CliNumero Alfa-Numérico 10 Número da residência do cliente
CliComplemento Alfa-Numérico 100 Complemento do endereço do cliente
CliBairro Alfa-Numérico 100 Bairro do cliente
CliCidade Alfa-Numérico 100 Cidade do cliente
CliEstado Alfa-Numérico 2 Estado do cliente
CliCEP Alfa-Numérico 10 CEP do cliente
Formato: 00000000
CliTelefone Alfa-Numérico 16 Telefone do cliente
Formato: 00 00000000
ProdID_x Alfa-Numérico 100 ID do produto
ProdDescricao_x Alfa-Numérico 100 Descrição do produto
ProdValor_x Decimal 10,2 Valor unitário do produto
ProdQuantidade_x Numérico 5 Quantidade comprada do produto
ProdFrete_x Decimal 10,2 Valor do frete deste produto
Formato: 0,00
NumItens Numérico 5 Quantidade de itens recebidos.
Parcelas Numérico 2 Quantidade de parcelas do pagamento. Para pagamentos à vista (TEF, boleto e Saldo PagSeguro) a quantidade de parcelas informada sempre será 1.

Encoding

O POST encaminhado pelo PagSeguro com os detalhes da transação estará no formato ISO-8859-1.

Ao solicitar a confirmação do POST NPI, encaminhe para conferência exatamente o POST que recebeu, não faça transformações.

Como o vendedor deverá configurar a Retorno Automático na conta

  Ativar a URL de Retorno
Informe para o o seu cliente, o padrão da URL de retorno do seu sistema ou solução.
Exemplo: https://www.lojamodelo.com.br/sistema/RetornoPS.asp?IDLoja=99999

  Gerar o token de segurança e adicioná-lo na administração da loja.