Creating a notification of type: "Instant Payment Notification"

  1. Select the notification type: Instant Payment Notification.
  2. Click Next.
  3. Select one or more trigger events from the proposed list:
    Some events are available only if the corresponding options are activated.
    Type of event
    Payment accepted

    The rule is triggered when a transaction is created with one of the following statuses: "Waiting for capture", "To be validated", "Captured" , "Waiting for authorization", "To be validated and authorized".

    Payment declined

    The rule is triggered when a transaction is created with one of the following statuses:

    "Refused", "Expired".

    Payment abandoned by the buyer

    The rule is triggered when the buyer clicks on the "Cancel and return to the shop" button or after expiration of the payment session.

    Pending payment waiting for a confirmation of the external platform

    The rule is trigger when a transaction is created in a temporary status (FacilyPay, Sofort, PayPal).

    Transaction refunded by the merchant

    The rule is triggered when the merchant performs a refund.

    Transaction canceled at the initiative of the merchant

    The rule is triggered when the merchant performs a refund.

    Transaction declined during the automatic authorization process

    The rule is triggered in case of declined authorization for a differed payment.

    Transaction authorized by automatic batch authorization

    The rule is triggered in case of successful authorization for a differed payment.

    Transaction modified by the merchant or the acquirer

    The rule is triggered when the merchant or the acquirer modifies a transaction.

    Transaction validated by the merchant

    The rule is triggered when the merchant validates a transaction.

    New installment of a recurring payment

    The rule is triggered when creating a new installment of a recurring payment.

    Transaction duplicated by the merchant

    The rule is triggered when the merchant duplicates a refund.

    Token update

    The rule is triggered when payment method details associated to the token are updated.

    Token creation

    The rule is triggered when creating a token.

    SEPA direct debit pre-notification

    The rule is triggered when the pre-notification e-mail is sent to the debtor.

    Creation of a recurring payment

    The rule is triggered when creating a new recurring payment.

  4. Configure the Rule conditions.
    A condition is composed of a variable, a comparison operator and a reference value.
    1. Click on the Add button.
    2. Select a variable among the proposed list.
      Variable Description
      Amount (cents) Allows to define a condition based on the amount (in cents).
      Mode (Test or Production) Allows to define a condition based on the solicitation mode of the payment gateway (Test allows to make test payments, Production allows to make real payments).
      Payment method Allows to define a condition based on the available payment methods (currencies, technical constraints, etc.) associated with the shop.
      Event source Allows to define a condition based on the origin of the payment:
      • Payment page
      • Resending of a notification from the Back Office
      • File process
      • Recurring payment
      • Automatic authorization process
      • Other automatic process
      • Back Office
      • Webservice
      • Payment by IVR
      • Automatic resending of a failed notification
      • REST API
      Installment payment Allows to define a condition based on the type of the payment.
      Informative risk assessment Allows to define a condition based on the risk assessment result:
      • Failed
      • Passed
    3. Select an operator among the proposed list.
      The suggested operators are specific to the selected variable:
      • equal to
      • different to
      • greater than
      • greater than or equal to
      • less than
      • less than or equal to
      • is on the list
      • is not on the list
    4. Select or type a value (depending on the selected variable).
      Example:
      During the execution of a rule, the value of a variable is retrieved and compared to the reference value.
      All the conditions must be validated for the rule to be executed.
  5. Click Next.
  6. In the General settings section, fill the fields:
    • Rule reference
    • E-mail address to notify in case of failure
    • Automatic retry in case of failure.
  7. In the Instant Payment Notification URL of the API form V1, V2 section, fill the fields:
    • URL to notify in TEST mode
    • RL to notify in PRODUCTION mode
  8. Click Create.