Registering a mandate and making a payment

In order to register a recurring mandate and make a payment:

  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 required to register a mandate and perform a payment REGISTER_PAY
    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
    vads_amount Payment amount (in the smallest currency unit) Example: 2990 for 29.90€
    vads_currency Code of the payment currency 978 for Euro
  2. Set vads_page_action to REGISTER_PAY.
  3. Set vads_action_mode to INTERACTIVE.SEPA Direct Debit is not compatible with the SILENT mode.
  4. Set the vads_currency field to 978 (Euro currency code).Only the Euro currency is accepted for this payment method.
  5. Populate the vads_amount field with an amount in the smallest currency unit (in cents for Euro).
  6. 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
  7. 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.
  8. Add optional fields according to your requirements (see chapter Using additional functions).
  9. 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_PAY" />
<input type="hidden" name="vads_site_id" value="70258842" />
<input type="hidden" name="vads_amount" value="2990" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_trans_date" value="20140919130128" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="96b2a17b9a5fcefb6c0120c57b25ec86ad1704ee"/>
<input type="submit" name="pay" value="Pay"/>
</form>