Registering a mandate

The registration of a recurring mandate corresponds to creating a token.

The token can be later used for:

  • performing a payment,
  • creating a subscription,
  • using a file sharing service. Using this form together with a file sharing service allows for each direct debit to have a different amount and due date.
  • etc

    In order to register a recurring mandate:

  1. Use all the fields of 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 required to register a mandate and perform a payment REGISTER
    vads_version Version of the exchange protocol V2
    vads_cust_email Buyer's e-mail address.

    Note:

    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.

    Eg.: name@example.com
  2. Set vads_page_action to REGISTER.
  3. Set vads_action_mode to INTERACTIVE.SEPA Direct Debit is not compatible with the SILENT mode.
  4. 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).

    Note:

    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
  5. Set vads_payment_cards if you would like to pre-select the payment method on the merchant website.

    Note:

    • 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.
  6. Add optional fields according to your requirements (see chapter Using additional functions).
  7. 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="https://secure.payzen.eu/vads-payment/">
<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="name@example.com" />
<input type="hidden" name="vads_page_action" value="REGISTER" />
<input type="hidden" name="vads_site_id" value="70258842" />
<input type="hidden" name="vads_trans_date" value="20140919130128" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="54b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/>
<input type="submit" name="pay" value="Pay"/>
</form>