Analyser la nature de la notification

Le champ vads_url_check_src permet de différencier les notifications en fonction de leur évènement déclencheur :

  • création d'un alias (avec ou sans souscription à un abonnement).
  • paiement d'une échéance d'un abonnement.
  • renvoi de la notification depuis le Back Office Marchand par le marchand.

Il précise la règle de notification appliquée :

Tableau 1. Valeurs associées au champ vads_url_check_src
Valeur Règle appliquée
PAY

La valeur PAY est envoyée dans les cas suivants :

  • demande de création d'un mandat ou d'un alias (REGISTER)
  • demande de création d'un mandat ou d'un alias lors de la souscription à un abonnement (REGISTER_SUBSCRIBE)
  • paiement immédiat (paiement comptant ou première échéance d'un paiement en plusieurs fois)
  • paiement abandonné ou annulé par l'acheteur

    uniquement si le marchand a configuré la règle URL de notification sur annulation.

BO

Exécution de la notification depuis le Back Office Marchand (clic droit sur une transaction > Executer l'url de notification).

Testez la présence du champ vads_recurrence_number:
  • s'il est présent, alors la notification concerne le résultat d'un paiement récurrent (rejeu d'une notification de type REC),
  • s'il est absent, alors la notification concerne une notification de fin de paiement.
BATCH

La valeur BATCH est envoyée dans le cas de la mise à jour du statut d'une transaction après synchronisation auprès de l'acquéreur.

C'est le cas des paiements à redirection vers l'acquéreur.

Uniquement si le marchand a configuré la règle URL de notification sur modification par batch.

BATCH_AUTO

La valeur BATCH_AUTO est envoyée dans les cas suivants:

  • paiement différé à plus de 7 jours
  • échéances d'un paiement en plusieurs fois (hormis la première)

    uniquement si le marchand a configuré la règle URL de notification sur autorisation par batch.

La notification est envoyée lors de la demande d’autorisation d'un paiement dont le statut est "En attente d’autorisation".

REC

La valeur REC est envoyée uniquement pour les paiements par abonnement si le marchand a configuré la règle URL de notification à la création d'un paiement récurrent.

MERCH_BO

La valeur MERCH_BO est envoyée :

  • lors d'une opération réalisée depuis le Back Office Marchand (annulation, remboursement, modification, validation, duplicata, création et/ou mise à jour d'alias), si le marchand a configuré la règle de notification : URL de notification sur une opération provenant du Back Office
RETRY

Rejeu automatique de l’URL de notification.

Testez la présence du champ vads_recurrence_number:
  • s'il est présent, alors la notification concerne le résultat d'un paiement récurrent (rejeu d'une notification de type REC),
  • s'il est absent, alors la notification concerne une notification de fin de paiement.

En testant sa valeur, le script peut réaliser un traitement différent en fonction de la nature de la notification.

Par exemple :

Si vads_url_check_src est valorisé à PAY ou BATCH_AUTO alors le script met à jour le statut de la commande, ...

Si vads_url_check_src est valorisé à REC alors le script récupère la référence de l'abonnement et incrémente le nombre d'échéances échues en cas de paiement accepté, ...

Dans le cadre d'un prélèvement récurrent (issu d'un REGISTER_SUBSCRIBE), la plateforme de paiement notifie le créancier (marchand) lors de la création de chaque transaction.