Re-chamada automática em caso de falha

A re-chamada automática não se aplica às notificações enviadas manualmente a partir do Back Office Estabelecimento Comercial.

O Estabelecimento Comercial pode ativar um mecanismo que permite à plataforma enviar de novo automaticamente as notificações quando o site de e-commerce encontra-se indisponível, até 4 vezes.

Uma autenticação será considerada em falha se o código de retorno HTTP retornado pelo site de e-commerce não constar na lista seguinte: 200,201, 202, 203, 204, 205, 206, 301, 302,303, 307, 308.

As tentativas de chamadas são programadas a horários fixos a cada 15 minutos (00, 15, 30, 45).

Após cada tentativa sem sucesso, um e-mail de alerta é enviado ao endereço especificado na configuração da regra de notificação em questão.

O título do e-mail de aviso apresenta o número da tentativa de envio da notificação. Ele é apresentado sob a forma attempt # seguido do número de tentativa.
  • Exemplo de título de um e-mail recebido após a primeira falha de notificação no final de um pagamento:
    [MODE TEST] Minha loja - Tr. ref. 067925 / FALHA durante a chamada da sua URL de notificação [unsuccessful attempt #1]
  • Exemplo de título de e-mail recebido após uma segunda falha:
    [MODE TEST] Minha loja - Tr. ref. 067925 / FALHA durante a chamada da sua URL de notificação [unsuccessful attempt #2]
  • Exemplo de título de e-mail recebido após uma terceira falha:
    [MODE TEST] Minha loja - Tr. ref. 067925 / FALHA durante a chamada da sua URL de notificação [unsuccessful attempt #3]
  • Exemplo de título de e-mail recebido após a última tentativa:
    [MODE TEST] Minha loja - Tr. ref. 067925 / FALHA durante a chamada da sua URL de notificação [unsuccessful attempt #last]

    Para notificar ao site de e-commerce a falha da última tentativa de notificação, o título do e-mail apresentará a menção attempt #last.

Durante a re-chamada automática, algumas informações não são registradas no banco de dados ou são modificadas.

Exemplos de campos não disponíveis / não salvos em banco de dados:

Nome do campo Descrição
vads_page_action Operação realizada
vads_payment_config Tipologia de pagamento (à vista ou parcelado)
vads_action_mode Modo de aquisição dos dados do meio de pagamento

Exemplos de campos enviados com valores diferentes:

Nome do campo Novo valor
vads_url_check_src Sempre com o valor de RETRY para uma re-chamada automática.
vads_trans_status O status da transação pode variar entre a chamada inicial e a re-chamada automática (cancelamento do Estabelecimento Comercial, captura no banco da transação, etc.).
vads_hash O valor deste campo é gerado de novo a cada chamada.
signature O valor da assinatura depende dos diferentes status que podem variar entre a chamada inicial e a re-chamada automática.

Estes e-mails apresentam em detalhes:

  • o problema encontrado
  • elementos de análise em função do erro
  • as suas consequências
  • os passos a seguir a partir do Back Office Estabelecimento Comercial para enviar manualmente a notificação.

Observação:

Após a quarta tentativa, pode-se também chamar de novo a URL de notificação manualmente no seu Back Office Estabelecimento Comercial.

Atenção, durante a re-chamada automática, toda chamada manual para a URL de notificação vai afetar o número de tentativas automáticas:
  • uma chamada manual realizada com sucesso encerra a re-chamada automática
  • um chamada manual em falha não terá impacto na re-chamada automática em andamento.