Processing the response to a mandate update and analyzing the payment result

  1. Analyze the result of the mandate update by testing the value of the vads_identifier_status field.
    Table 1. Values of the vads_identifier_status field
    Value Description
    CREATED

    Mandate is successfully registered.

    NOT_CREATED

    Mandate has not been created and cannot be viewed in the Back Office. No direct debits will be made.

    UPDATED Mandate has been successfully updated.
    ABANDONED

    Mandate registration has been abandoned by the debtor (buyer).

    Mandate has not been created and cannot be viewed in the Back Office. No direct debits will be made.

  2. Retrieve mandate details:
    Table 2. Mandate details
    Field Description
    vads_identifier Returns the token (Unique Mandate Reference).

    This value will be used later to make a payment, create a subscription, exchange files, etc.

    vads_card_number Returns the IBAN and BIC, separated by a "_".
    vads_expiry_month

    Returns the expiration month of the mandate

    vads_expiry_year Returns the expiration year of the mandate
  3. Analyze the transaction result by testing the value of the vads_trans_status field:
    Table 3. Values of the vads_url_check_scr field
    Value Description
    ABANDONED The payment has been abandoned by the buyer. The transaction has not been created and cannot be viewed in the Back Office.
    AUTHORISED

    A pre-notification has been sent. The direct debit is waiting to be captured.

    AUTHORISED_TO_VALIDATE

    The direct debit request has been made in manual validation mode.

    The merchant must manually validate the transaction in the Back Office to allow the mandate to be sent to the bank.

    The pre-notification will only be sent after the transaction has been validated.

    An automatic e-mail is processed every day, several times per day (every 3 hours) that does not require any intervention on your behalf.

    The transaction can be validated as long as the capture date has not passed. If the capture date has passed, the payment status changes to Expired. The expired status is final.

    WAITING_AUTHORISATION

    The pre-notification has not been sent yet.

    The direct debit request has been made with a capture delay greater (strictly) to 14 days while the pre-notification delay in the contract is 14 days.

  4. Retrieve the transaction details:
    Table 4. Parameter list - Transaction details
    Field name Description
    vads_trans_id Returns the transaction identifier.
    vads_presentation_date Returns the desired due date.
    vads_amount Payment amount (in cents).
    vads_currency Numeric code of the euro currency (978).