• France
status page
Demo shops
assistance
FAQContact support
Search
Categories
Tags
Europe (English)
France
Spain
Europe (English)
India
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
SDD mandates by REST API
Snippets
Payment methods
Plugins
Marketplace
Guides
Merchant Back Office
Back Office Expert
Functional guides

Analyzing the nature of the notification

In a notification, field vads_url_check_src allows to differentiate the notifications based on their triggering event:

  • creation of a transaction
  • new notification sent by the merchant via the Expert Back Office.

It specifies the applied notification rule.

Values associated with the vads_url_check_src field:

Value Description
PAY

Payment creation by form.

Value is sent in the following cases:
  • registration request for a mandate or a token (REGISTER)
  • registration request for a mandate or a token when subscribing to a recurring payment (REGISTER_SUBSCRIBE)
  • immediate payment (or first installment payment of a recurring payment)
  • payment deferred for less than 7 days
  • payment abandoned or canceled by the buyer

    Only if the merchant has configured the “Instant Payment Notification URL on cancellation” rule.

BO Execution of the notification URL from the Expert Back Office. (Right-click a transaction > Send the Instant Payment Notification).
BATCH_AUTO

Value sent as part of an authorization request for a payment that was awaiting authorization.

Not applicable for one-off direct debit on SEPA.

BATCH

Value sent in case of an update of a transaction status after its synchronization on the acquirer side.

Only if the merchant has configured the “Instant Payment Notification URL on batch change” rule.

DCF Value sent following a transaction originating from the data collection form.
MERCH_BO Value sent following an operation made via the Expert Back Office if the merchant has configured the following notification rule: “Instant Payment Notification URL on an operation coming from the Back Office”.
PAYMENT_ORDER Value sent following a transaction originating from a payment order (e-mail, payment URL or SMS).
REC

Value is sent only for recurring payments if the merchant has configured the Instant Payment Notification “URL when creating recurring payments rule”.

Not applicable for SEPA one-off direct debit.
RETRY Automatic retry of the IPN.

After checking its value, the script can 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 updates the order status, ...

If vads_url_check_src is valued at REC the script will retrieve the recurring payment reference and will increment the number of the expired installment payments in case the payment has been accepted, etc.

Jobs
Legal
GDPR
25.18-1.11