• France
status page
demonstrations
assistance
FAQContact support
Search
Categories
Tags
English
French
English
Homepage
Use cases
Create a payment
Create an installment payment
Create a multi-card (split) payment
Create a payment by Alias (Token)
Create a payment link
Create a recurring payment
Manage subscriptions
Manage your transactions (refund, cancel...)
Analyze your reports
API docs
Embedded Form
REST API
Hosted payment
Mobile payment
File exchange
Snippets
Payment methods
Plugins
Guides
Merchant Back Office
Functional guides

Updating a mandate

  1. Use all the fields presented in the table below to create your payment form.
    Field name Description Value
    vads_action_mode Acquisition mode for bank data. INTERACTIVE
    vads_ctx_mode Operating mode TEST or PRODUCTION
    vads_cust_email Buyer's e-mail address. E.g.: mymail@example.com
    vads_identifier Reminding the token ID to be updated. E.g.: 22e75ce992afe18da10
    vads_page_action Action required to update a mandate and make a payment REGISTER_UPDATE
    vads_site_id Shop ID E.g.: 12345678
    vads_trans_date Date and time of the payment form in UTC format E.g.: 20200526130921
    vads_version Version of the exchange protocol V2
  2. Set vads_page_action to REGISTER_UPDATE.
    Note:
    Not to be confused with REGISTER_UPDATE_PAY and REGISTER_UPDATE.
    REGISTER_UPDATE allows to only update a mandate without making a payment.
  3. If the debtor’s details are updated, the new details must be transmitted via the merchant website. The payment page will not provide entry fields. Use the fields below:
    Field name Description Value
    vads_cust_address Buyer's address.  
    vads_cust_cell_phone Buyer’s cell phone number for sending the security code (by SMS). E.g.: 0612345678
    vads_cust_country Allows to specify the country code in compliance with the ISO 3166 standard. E.g.: FR
    vads_cust_first_name Allows to specify the buyer’s first name E.g.: John
    vads_cust_last_name Allows to specify the buyer’s last name E.g.: Smith
    vads_cust_title Allows to specify the buyer’s title. E.g.:
    • Mr
    • Mrs
    • Ms
  4. Compute the value of the signature field using all the fields of your form that start with vads_ (see chapter Computing the signature).
Example of a form:
<form method="POST" action="https://sogecommerce.societegenerale.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="surname.name@example.com" />
<input type="hidden" name="vads_cust_address" value="rue de l'innovation" />
<input type="hidden" name="vads_cust_zip" value="31670" />
<input type="hidden" name="vads_cust_city" value="Labege" />
<input type="hidden" name="vads_cust_country" value="FR" />
<input type="hidden" name="vads_identifier" value="22e75ce992afe18da10" />
<input type="hidden" name="vads_page_action" value="REGISTER_UPDATE" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20200526130921" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="k+qSipEEba8hsXXmHHc02ulUB9hSHnLt7myuPpBUhxY="/>
<input type="submit" name="pay" value="Pay"/>
</form>
© 2025 {'|'} All rights reserved to Sogecommerce
25.18-1.11