Processing the response to a request for a subscription 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_url_check_scr 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 the 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 subscription, exchanging 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 result of mandate creation by testing the value of the vads_recurrence_status field.
    Table 3. Values of the vads_url_check_scr field
    Value Description
    CREATED

    A subscription has been successfully created.

    Subscription details are visible in the Back Office.
    NOT_CREATED The subscription has not been created and is not visible in the Back Office. No direct debits can be made.
    ABANDONED

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

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

Exemple 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 = 20140925090433
vads_trans_id = 
vads_validation_mode = 0
vads_version = V2
vads_warranty_result = NO
vads_payment_src = EC
vads_cust_email = lastname@example.com
vads_cust_last_name = Lastname
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 = 20140925fRbwlu
vads_subscription = 20140925FRwRw9
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 = 20141101
signature = a5026f230479eb17739609cb98c0e70e6516a006