Analisar o resultado do pagamento

Após todo pagamento (aceito ou recusado), a plataforma envia uma notificação com o resultado para o site de e-commerce.

Esta notificação é também chamada IPN.

Para tratar as notificações, o Estabelecimento Comercial deve elaborar uma página dedicada que analisa os dados enviados em modo POST (exemplo de URL: https://site-de-ecommerce.com/analise_pagamento.php).

Em função do resultado, esta página deve lançar ações diversas (alterar o status do pedido, atualizar os estoques, etc).

Requisitos:

  • A URL da página que analisa o resultado do pagamento deverá obrigatoriamente ser informada no Back Office Estabelecimento Comercial (ver capítulo Configurar as notificações).
  • O Estabelecimento Comercial deverá garantir que esta URL pode ser alcançada pela plataforma de pagamento, e isso sem redirecionamento.

    Os redirecionamentos provocam a perda de dados presentes no POST.

  • Em caso de restrições estabelecidas pelo site de e-commerce, a faixa de endereços IP autorizada é: 194.50.38.0/24.
    As notificações são enviadas a partir de um endereço IP que consta na faixa 194.50.38.0/24 em modo de Teste e em modo de Produção.
  • A página não deve conter exibições HTML.

    Acessar recursos como imagens ou folhas de estilo diminuem a velocidade das trocas entre a plataforma de pagamento e o site de e-commerce.

  • Evite o quanto puder neste script tarefas que necessitam tempo tal como gerar uma fatura ou enviar e-mail.

    O tempo de tratamento impacta diretamente o prazo de exibição da página resumida do comprador. Quanto mais o tratamento demorar, mais longo o tempo de espera antes de visualizar.

    Após 35s, a plataforma considera que a chamada falhou (timeout).

Falha de notificação (IPN)

Se falhar a chamada para a URL de notificação (IPN), um e-mail de alerta será enviado para o endereço informado no Back Office Estabelecimento Comercial (ver capítulo Configurar as notificações).

Contém:

  • o código HTTP do erro encontrado,
  • elementos de análise segundo o erro,
  • o procedimento a seguir para enviar a notificação a partir do Back Office Estabelecimento Comercial.

Para ajudar o Estabelecimento Comercial a identificar a origem do erro, a plataforma analisa sistematicamente os 512 primeiros dígitos retornados pelo site de e-commerce.

Estes dígitos estão depois exibidos no detalhe das transações, na aba Histórico:

Conceber o script de tratamento

O script de tratamento deve conter pelo menos as etapas a seguir:

  • Recuperar a lista dos campos presentes na resposta enviada em POST
  • Calcular a assinatura levando em conta os dados recebidos
  • Comparar a assinatura calculada com a assinatura recebida
  • Analisar a natureza da notificação
  • Recuperar o resultado do pagamento

O script pode por exemplo testar o status do pedido (ou a informação da sua escolha) para verificar que não tenha sido atualizada já.

Uma vez que estas etapas foram realizadas, o script pode atualizar a base de dados (novo status do pedido, atualização do estoque, informações salvas do pagamento etc.).