Creating a recurring mandate signature request

To request the signature of a recurring SEPA mandate:

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. If the buyer’s e-mail address is pre-filled on the payment page, the buyer can modify it when signing the mandate. If the buyer’s e-mail address in unknown, the buyer will be prompted to specify it on the payment page.	E.g.: mymail@example.com
vads_page_action	Action required to register a mandate and make a payment	REGISTER
vads_payment_cards	Payment method	SDD
vads_site_id	Shop ID	E.g.: 12345678
vads_trans_date	Date and time of the payment form in UTC format	E.g.: 20200519130128
vads_version	Version of the exchange protocol	V2

It is recommended to transmit the buyer’s full address. Some banks check whether this information is present before accepting a direct debit request. Moreover, when this information is specified, the corresponding fields will be pre-filled on the mandate signature page.

Field name	Description	Value
vads_cust_address	Buyer’s address The buyer’s postal address is required if the client has a bank account in the following departments, territories or countries: Switzerland, Monaco, San Marino, Mayotte, St. Pierre and Miquelon, Guernsey, Jersey, Isle of Man.
vads_cust_cell_phone	Buyer’s cell phone number for sending the security code (by SMS). If the buyer’s cell phone number (the phone number registered during the subscription) is pre-filled on the payment page, the buyer can modify it when signing the mandate. Only GSM-users having recorded this phone number at the moment during their subscription can receive an SMS with this access code for single use. If the buyer’s cell phone number in unknown, the buyer will be prompted to specify it on the payment page.	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

If the value of the vads_cust_cell_phone field is provided in international format (+336xxxxxxxx) or if the fields vads_cust_cell_phone and vads_cust_country are both populated, the security code will be systematically sent by SMS regardless of the signature mode configured in the shop.

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://secure.gateway.monetico-retail.com/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="firstName.lastName@example.com" />
<input type="hidden" name="vads_page_action" value="REGISTER" />
<input type="hidden" name="vads_payment_cards" value="SDD" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_trans_date" value="20200519130128" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="jv08cn/Qa5jRA8cl80jzN/TlhNG2oUY8b4sJwNXF/70="/>
<input type="submit" name="pay" value="Pay"/>
</form>

Categories

Tags

Creating a recurring mandate signature request