IMPORTANTE!
Consulte o notificationCode enviado para a URL de notificação que cadastrou em sua conta ou enviou no XML do POST de solicitação de autorização.
Fazendo isso, o retorno será as permissões autorizadas do seller inclusive demais dados como a publicKey do mesmo.
Após o comprador autorizar a aplicação, o PagSeguro enviará via POST uma notificação ao seu sistema com o status da autorização.
A imagem abaixo ilustra o funcionamento da notificação. Note que é o PagSeguro que inicia o processo de notificação ao enviar um código para seu sistema.
Para utilizar a API de Notificações você deve primeiramente ter criado uma aplicação. O endereço (URL) de notificação é configurado no momento da criação da aplicação, porém pode ser passado também como parâmetro na chamada como vimos no tópico Solicitando autorização.
A visualização ou alteração desta URL em uma aplicação já existente pode ser feita através da página de listagem de aplicações no endereço https://pagseguro.uol.com.br/aplicacao/listagem.jhtml, clicando no botão "Editar".
Uma vez configurado o endereço para onde o PagSeguro irá enviar notificações, o próximo passo é preparar seu sistema para receber o código de notificação. O PagSeguro envia as notificações para a URL que você configurou usando o protocolo HTTP, pelo método POST.
Veja abaixo um exemplo de notificação enviada pelo PagSeguro (as linhas foram quebradas para facilitar a leitura):
POST http://lojamodelo.com.br/notificacao HTTP/1.1
Host:pagseguro.uol.com.br
Content-Length:85
Content-Type:application/x-www-form-urlencoded
notificationCode=766B9C-AD4B044B04DA-77742F5FA653-E1AB24
¬ificationType=applicationAuthorization
| PARÂMETRO | |
|---|---|
notificationCode | O código que identifica a notificação. Este código deve ser usado para consultar a notificação e obter os dados da transação/assinatura associada. Note que o código que identifica a notificação não é o mesmo que o código que identifica a transação. Tipo: Texto. Formato: Uma sequência de 39 caracteres. |
notificationType | O tipo da notificação enviada. Tipo: Texto. Formato: Para notificações de autorização será applicationAuthorization. |
Note que a notificação não possui nenhuma informação sobre a autorização. Portanto, assim que seu sistema recebe uma notificação, ele deve consultá-la para obter os dados, como descrito no tópico Consultas.
Lembre-se que, enquanto seu sistema não consultar uma notificação enviada, o PagSeguro irá enviá-la novamente a cada 2 horas, até um máximo de 5 tentativas. Se seu sistema ficou indisponível por um período maior que este e não recebeu nenhum dos envios da notificação, ainda assim é possível obter os dados de suas autorizações usando a Consulta de Autorizações.