Saving a mandate and set a fixed subscription

To save a recurring mandate and create a subscription with fixed amounts and fixed dates:

  1. Use all the fields in the table below to create your payment form.
    Table 1. Field list - Recurring payment by SEPA Direct Debit
    Field name Description Value
    vads_site_id Shop ID Eg.: 12345678
    vads_ctx_mode Operating mode TEST or PRODUCTION
    vads_trans_date Date and time of the payment form in UTC format Eg.: 20140919130128
    vads_action_mode Acquisition mode for bank data. INTERACTIVE
    vads_page_action Action to perform REGISTER_SUBSCRIBE
    vads_version Version of the exchange protocol V2
    vads_cust_email Buyer's e-mail address.


    The buyer cannot modify the pre-filled e-mail address on the payment page.

    If the e-mail address in unknown, the buyer will have to enter it on the payment page.

    vads_sub_effect_date Subscription start date. Eg.: 20141002
    vads_sub_amount Installment amount (in the smallest currency unit) Eg.: 2990 for 29.90€
    vads_sub_currency Numerical code of the currency to be used 978 for Euro
    vads_sub_desc Rule for recurring payments to apply Eg.: RRULE:FREQ=MONTHLY;


  2. Set vads_page_action to REGISTER_SUBSCRIBE.
  3. Set vads_action_mode to INTERACTIVE.
    SEPA Direct Debit is not compatible with the SILENT mode.
  4. Set vads_sub_effect_date.
    For technical reasons, the due date must be at least 14 calandar days from the submission date of the form (vads_trans_date).
  5. Set vads_currency to 978 (Euro code currency).
    Euro is the only currency accepted.
  6. Set vads_sub_desc.
    Examples of subscription rules:
    • To program installment payments taking place on the last day of each month for 12 months, the rule is:


    • To program installment payments every three months until December 31th 2016, the rule is:


    • To program installment payments for the last day of each month for 12 months, the rule is:


  7. If you would like to pre-fill the form, add the optional fields of the table below to create your payment form:
    Table 2. Field list - Recurring payment by SEPA Direct Debit
    Field name Description Value
    vads_cust_title Allows to specify the buyer's title. Eg.:
    • Mr
    • Mrs
    • Ms
    vads_cust_last_name Allows to specify the buyer's last name. Eg.: Dupont
    vads_cust_first_name Allows to specify the buyer's first name. Eg.: Jean
    vads_cust_cell_phone Buyer cell phone number to receive the security code (by SMS).


    The buyer cannot modify the pre-filled cell phone number on the payment page. Only GSM-users having recorded this phone number at the moment of subscription can receive an SMS with this access code for single use.

    If the phone number in unknown, the buyer will have to enter it on the payment page.

    Eg.: 0612345678
    vads_cust_country Allows to specify the buyer's country code in compliance with the ISO 3166 standard. Eg.: FR
  8. Set vads_payment_cards if you would like to pre-select the payment method on the merchant website.


    • If this list contains only one card type, the data entry page for this payment method will directly appear.

      Expected value for SEPA Direct Debit is SDD.

    • If there are more than one card types, the page with payment method selection will appear.
    • If this parameter is empty (recommended), the available payment methods (currencies, technical constraints, etc.) associated with the shop will be proposed.
  9. Add optional fields according to your requirements (see chapter Using additional functions).
  10. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).
Example of a form:
<form method="POST" action="">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_ctx_mode" value="TEST" />
<input type="hidden" name="vads_cust_email" value="" />
<input type="hidden" name="vads_page_action" value="REGISTER_SUBSCRIBE" />
<input type="hidden" name="vads_site_id" value="70258842" />
<input type="hidden" name="vads_sub_amount" value="2990" />
<input type="hidden" name="vads_sub_currency" value="978" />
<input type="hidden" name="vads_sub_desc" value="RRULE:FREQ=MONTHLY;BYMONTHDAY=1" />
<input type="hidden" name="vads_sub_effect_date" value="20141002" />
<input type="hidden" name="vads_trans_date" value="20140919130128" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="86b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/>
<input type="submit" name="pay" value="Pay"/>