Analisar a natureza da notificação

Durante uma notificação o campo vads_url_check_src permite discriminar as notificações em função dos eventos que fizeram disparar cada uma delas:

  • criação de uma transação.
  • retorna a notificação a partir do Back Office Estabelecimento Comercial pelo Estabelecimento Comercial.

Ele menciona a regra de notificação aplicada:

Tabela 1. Valores associados a vads_url_check_src
Valor Regra aplicada
PAY

O valor PAY é enviado nos seguintes casos:

  • pagamento à vista (pagamento à vista ou primeira parcela de um pagamento parcelado)
  • pagamento pré-datado com menos de 7 dias

    somente se o Estabelecimento Comercial configurou a regra URL de notificação no final do pagamento.

  • o comprador desistiu ou cancelou o pagamento

    somente se o Estabelecimento Comercial configurou a regra URL de notificação de anulação.
BO

Execução da notificação a partir do Back Office Estabelecimento Comercial (clique direito em uma transação > Executar a URL de notificação).
BATCH

O BATCH será enviado se houver uma atualização do status de uma transação após a sincronização com o adquirente.

É o que acontece com pagamentos redirecionados para o adquirente.

Somente se o Estabelecimento Comercial configurou a regra Url de notificação para uma modificação por batch.
BATCH_AUTO

O valor BATCH_AUTO é enviado nos seguintes casos:

  • pagamento pré-datado com mais de 7 dias
  • prestações de um pagamento parcelado (com exceção da primeira)

    somente se o Estabelecimento Comercial configurou a regra Url de notificação para uma autorização por batch.

A notificação é enviada durante a solicitação de autorização de um pagamento com o status de "Esperando a autorização".
REC

O valor REC é enviado somente para os pagamentos por assinatura se o Estabelecimento Comercial configurou a regra URL de notificação na criação de um pagamento recorrente.
MERCH_BO

O valor MERCH_BO é enviado:

  • durante uma operação realizada a partir do Back Office Estabelecimento Comercial (cancelamento, reembolso, modificação, validação, duplicata, criação e/ou atualização de um Token Cartão), se o Estabelecimento Comercial configurou a regra de notificação: Url de notificação para uma operação proveniente do Back Office
RETRY

Re-chamada automática a URL de notificação.

Testando seu valor, o script pode realizar um tratamento diferente em função da natureza da notificação.

Por exemplo:

Se vads_url_check_src tem o valor de PAY ou de BATCH_AUTO então o script atualiza o status da solicitação, ...

Se vads_url_check_src tem o valor de REC, o script recupera então a referência da assinatura e incrementa o número de parcelas vencidas no caso de um pagamento aceito, ...