Processing the response to a request for a recurring payment with a fixed date and amount

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

    The mandate has been successfully registered.

    NOT_CREATED

    The mandate has not been created and cannot be viewed in the Merchant Back Office. No direct debits can be made.

    UPDATED The mandate has been successfully updated.
    ABANDONED

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

    The mandate has not been created and cannot be viewed in the Merchant Back Office. No direct debits can be made.

  2. Retrieve mandate details:
    Table 2. Mandate details
    Field Description
    vads_identifier Returns the Unique Mandate Reference Number.

    This value will be used later for making a payment, creating a recurring payment, exchanging files, etc.

    vads_card_number Returns the IBAN and BIC, separated by a “_”.

    Since the BIC is optional, it may be left out.

    vads_expiry_month

    Returns the expiration month of the mandate

    vads_expiry_year Returns the expiration year of the mandate
  3. Analyze the result of recurring payment creation by testing the value of the vads_recurrence_status field.
    Table 3. Valuation of the vads_recurrence_status field
    Value Description
    CREATED

    The recurring payment has been successfully created.

    The recurring payment details are visible in the Merchant Back Office.
    NOT_CREATED The recurring payment has not been created and cannot be viewed in the Merchant Back Office. No direct debits can be made.
    ABANDONED

    Creation of the recurring payment has been abandoned by the debtor (buyer).

    The recurring payment has not been created and cannot be viewed in the Merchant Back Office. No direct debits can be made.
  4. Retrieve the details of the recurring payment:
    Table 4. Parameter list - Recurring payment details
    Field name Description
    vads_subscription Recurring payment ID
    vads_sub_effect_date Recurring payment start date.
    vads_sub_amount Amount of each installment (in cents) of the recurring payment, except the ones that will be eventually defined by the ads_sub_init_amount_number
    vads_sub_currency Numeric code of the currency (978).
    vads_sub_init_amount Amount of the first installments of the recurring payment.
    vads_sub_init_amount_number Number of installments to which the vads_sub_init_amount amount should be applied.
    vads_sub_desc Recurring payment rule to apply according to the iCalendar RFC5545 specification.

Example of a form :
vads_amount = 
vads_auth_mode = MARK
vads_auth_number = 
vads_auth_result = 
vads_capture_delay = 0
vads_card_brand = SDD
vads_card_number = FR7617515900001234567890135_CEPAFRPP751
vads_payment_certificate = 
vads_ctx_mode = TEST
vads_currency = 978
vads_effective_amount = 
vads_site_id = 91335531
vads_trans_date = 20160925090433
vads_trans_id = 
vads_validation_mode = 0
vads_version = V2
vads_warranty_result = NO
vads_payment_src = EC
vads_cust_email = surname.name@mymail.com
vads_cust_last_name = Surname
vads_contract_used = FR7630002005701234567890158
vads_recurrence_status = CREATED
vads_identifier_status = CREATED
vads_expiry_month = 9
vads_expiry_year = 2017
vads_pays_ip = FR
vads_identifier = 20160925fRbwlu
vads_subscription = 20160925FRwRw9
vads_threeds_enrolled = 
vads_threeds_cavv = 
vads_threeds_eci = 
vads_threeds_xid = 
vads_threeds_cavvAlgorithm = 
vads_threeds_status = 
vads_threeds_sign_valid = 
vads_threeds_error_code = 4
vads_threeds_exit_status = 4
vads_result = 00
vads_extra_result = 
vads_card_country = 
vads_language = fr
vads_hash = 8c094f21dca9f0279108a87efc0d5bc49337a8613451271e201d1cfcdbbbbeb3
vads_url_check_src = PAY
vads_action_mode = INTERACTIVE
vads_payment_config = SINGLE
vads_page_action = REGISTER_SUBSCRIBE
vads_sub_amount = 2990
vads_sub_currency = 978
vads_sub_desc = RRULE:FREQ=MONTHLY;BYMONTHDAY= 1
vads_sub_effect_date = 20161101
signature = a5026f230479eb17739609cb98c0e70e6516a006