Updating a mandate and making a payment

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

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_amount	Payment amount in the smallest currency unit	E.g.: 4525 for EUR 45.25
vads_ctx_mode	Operating mode	TEST or PRODUCTION
vads_currency	Currency euro code in compliance with the ISO 4217 standard.	Possible value: 978.
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_identifier	Unique Mandate Reference to update.	E.g.: 22e75ce992afe18da10
vads_page_action	Action required to update a mandate and make a payment	REGISTER_UPDATE_PAY
vads_payment_config	Payment type	SINGLE for immediate payment MULTI for installment payment
vads_site_id	Shop ID	E.g.: 12345678
vads_trans_date	Date and time of the payment form in UTC format	E.g.: 20200526131250
vads_trans_id	Transaction number	E.g.: PmZ34k
vads_version	Version of the exchange protocol	V2

Set vads_page_action to REGISTER_UPDATE_PAY.
Note:

Not to be confused with REGISTER_UPDATE_PAY and REGISTER_UPDATE.

REGISTER_UPDATE allows to only updating a mandate without making a payment.

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="nom.prenom@exemple.com" />
<input type="hidden" name="vads_identifier" value="22e75ce992afe18da10" />
<input type="hidden" name="vads_page_action" value="REGISTER_UPDATE_PAY" />
<input type="hidden" name="vads_site_id" value="12345678" />
<input type="hidden" name="vads_amount" value="2990" />
<input type="hidden" name="vads_currency" value="978" />
<input type="hidden" name="vads_payment_config" value="SINGLE" />
<input type="hidden" name="vads_trans_id" value="PmZ34k" />
<input type="hidden" name="vads_trans_date" value="20200526131250" />
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="rxFdxmHsYrj6OqBy6iXaipdSl1ihAI1NfRno5XkhtXY="/>
<input type="submit" name="pay" value="Pay"/>
</form>

Categories

Tags

Updating a mandate and making a payment