Integration of the Pledg payment solution

# Notification

A classical Notification mechanism (aka IPN, Instant Payment Notification) is available.

Notifications are sent from 2 fixed IPs that may need to be whitelisted in merchant's infrastructure to properly receive the requests.

Please also note that those requests use python-requests as User Agent. It may also be required to authorize this.

# Success

The merchant backend can be notified of the purchase completion if the optional parameter paymentNotificationUrl is provided when the purchase is created.

This webhook is a POST and its body is a JSON which fields depend on the payment mode (see back mode, transfer mode).

# Error

The merchant backend can be notified of an error occurring after the payment screen if the optional parameter errorNotificationUrl is provided when the purchase is created.

  • (deprecated) The notification is sent if the purchase state becomes one of BI_CANCELLED, BI_KO, BI_SCORING_KO, CONNECTOR_KO, PRIMARY_KO, SCORING_KO, TMX_SCORING_KO, VCP_KO, WORLDCHECK_FILTER_KO, FIRCOSOFT_FILTER_KO, FICP_FILTER_KO, RULE_ENGINE_FILTERS_KO, RULE_ENGINE_OPEN_BANKING_KO, COVERAGE_KO, MERCHANT_TIMEOUT.
  • The related acceptance_state is one of ABANDONED, REJECTED.
  • The notification is a POST request on errorNotificationUrl.

This webhook is a POST and its body is a JSON with the following fields:

{
   "reference" : "purchase_reference",
   "state" : "REVENUE_KO",
   "acceptance_state": "REJECTED"
   "uid" : "pur_6c48d42b-f29b-4f84-bee8-3cb2b964b600",
}

If there is a secret in the configuration of your merchant, it will be used to sign the notification body with jwt. In this case, only the signature is sent.

{
    "signature" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZWZlcmVuY2UiOiJwdXJjaGFzZV9yZWZlcmVuY2UiLCJwdXJjaGFzZV9zdGF0ZSI6IlBSSU1BUllfS08iLCJwdXJjaGFzZV91aWQiOiJwdXJfNmM0OGQ0MmItZjI5Yi00Zjg0LWJlZTgtM2NiMmI5NjRiNjAwIn0.375q0I_1Z8ZExa6aFwOvHdFvx4HTfpE-lbcHYlQ2nGs"
}

← By plugin →