Analyzing the nature of notification

The vads_url_check_src field allows to differentiate the notifications according to their triggering event (creation of a transaction, new notification sent by the merchant from the Back Office, etc.):

  • creating a transaction,
  • a new notification sent by the merchant from the Back Office.
It specifies the applied notification rule:
Table 1. Values of the vads_validation_mode field
Value Applied rule
PAY
The PAY value will be sent in the following cases:
  • immediate payment (or first installment payment),
  • deferred payment with a capture due date before/after the authorization expiration date (see the Authorization validity period section),

    Only if the merchant has configured the rule for Instant Payment Notification URL at the end of payment.

  • the payment that has been abandoned or canceled by the buyer,

    only if the merchant has configured the rule for Instant Payment Notification URL on cancellation.

BO Execution of the notification from the Back Office (right-click on a transaction > Execute the IPN URL).
BATCH_AUTO
The BATCH_AUTO value will be sent in the following cases:
  • deferred payment with a capture due date before/after the authorization expiration date (see the Authorization validity period section),
  • refund payments (except the first one),

    Only if the merchant has configured the rule for Instant Payment Notification URL on batch authorization.

The notification will be sent with the authorization request for payments with "Awaiting authorization" status.

REC

The REC value is sent only for subscription payments if the merchant has configured the rule for Instant Payment Notification URL when creating recurring payments.

MERCH_BO The MERCH_BO value will be sent in the following cases:
  • during operation performed from the Back Office (refund, modification, validation, duplication), only if the merchant has configured the following notification rule: Instant Payment Notification URL on an operation coming from the Back Office
  • during cancellations made from the Back Office, only if the merchant has configured the following notification rule: Instant Payment Notification URL on cancellation

After checking its value, the script will be able to process differently depending on the nature of the notification;

For example:

Si vads_url_check_src est valorisé à PAY ou BATCH_AUTO the script will update the order status, etc.

Si vads_url_check_src est valorisé à REC the script will retrieve the subscription reference and will increment the number of the expired installment payments in case the payment has been accepted, etc.