Postback

O postback é um mecanismo opcional de comunicação com o estabelecimento para o recebimento de atualizações de status de uma assinatura. Após a configuração da url de postback nos dados do estabelecimento, a cada atualização de status da assinatura será enviada uma requisição POST para o endereço configurado com os seguintes dados no corpo da requisição:

Observação: A relação de status possíveis de uma assinatura pode ser verificado na seção

Para que seja considerado sucesso no envio do postback, deve-se retornar um status 20x do protocolo http. Caso ocorra timeout ou um status diferente do esperado a tentativa é considerada como falha e será iniciado o processo de retentativa.

Caso o primeiro postback termine em falha serão feitas 3 retentativas de envio em um espaço de 5 minutos entre cada tentativa. Se ainda assim o postback falhar NÃO serão enviadas mais notificações sobre essa atualização de status.

O recurso de postback é apenas uma conveniência para facilitar a integração com o gestor de assinaturas, e está sujeito a falhas de comunicação, indisponibilidade de alguma das partes, etc. Desta forma, não elimina a necessidade de consultas periódicas ao status da assinatura que se deseja monitorar.

Outra questão importante é que o postback pode ser forjado, então quando um postback for recebido não se deve assumir que a informação é confiável. O sistema da 4all deve ser consultado para confirmar se aquela informação realmente é válida ou não. De certa forma, o postback deve ser usado como um trigger para ações.