Analisar a natureza da notificação

O campo vads_url_check_src permite diferenciar as notificações vinculadas em função do evento que lançou elas:

  • criação de um Token cartão (com ou sem contratação de uma assinatura).
  • pagamento de uma parcela de uma assinatura.
  • 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:

  • solicitação de criação de um mandato ou de um Token Cartão (REGISTER)
  • solicitação de criação de um mandato ou de um Token Cartão na contratação uma assinatura (REGISTER_SUBSCRIBE)
  • pagamento à vista (pagamento à vista ou primeira parcela de um pagamento parcelado)
  • 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).

Verifique a presença o campo vads_recurrence_number:
  • se presente, a notificação refere ao resultado de um pagamento recorrente (re-chamada de uma notificação de tipo REC),
  • se ausente, a notificação refere à notificação de fim de pagamento.
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.

Verifique a presença o campo vads_recurrence_number:
  • se presente, a notificação refere ao resultado de um pagamento recorrente (re-chamada de uma notificação de tipo REC),
  • se ausente, a notificação refere à notificação de fim de pagamento.

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, ...

No caso de um débito recorrente (proveniente de um REGISTER_SUBSCRIBE), a plataforma de pagamento notifica o credor (Estabelecimento Comercial) na criação de toda transação.