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 defines the notification rule applied:
Table 1. Values of the vads_url_check_src field
Value Applied rule
PAY
The PAY value will be sent in the following cases:
  • immediate payment (or first installment payment),
  • a deferred payment with a term of less than 7 days,

    only if the merchant has configured the rule End of payment notification URL.

  • the payment that has been abandoned or cancelled 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
RETRY Automatic retry of the IPN.

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

For example:

If vads_url_check_src is set to PAY or BATCH_AUTO, the script will update the order status, etc.

If vads_url_check_src is set to 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.