Creating a one-off direct debit request

In case of one-off direct debit, the buyer authorizes the merchant to withdraw the whole amount of the purchase in one go.

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_capture_delay	Capture delay	0
vads_ctx_mode	Operating mode	TEST or PRODUCTION
vads_currency	Currency code	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_page_action	Action to perform	PAYMENT
vads_payment_cards	Payment method	SDD
vads_payment_config	Payment type	SINGLE
vads_site_id	Shop ID	E.g.: 12345678
vads_trans_date	Date and time of the payment form in UTC format	E.g.: 20200516080441
vads_trans_id	Transaction number	E.g.: 3N2kj2
vads_version	Version of the exchange protocol	V2

Populate the vads_capture_delay field with 0 for the fund transfer to be executed maximum 14 calendar days after the purchase.

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://sogecommerce.societegenerale.eu/vads-payment/">
<input type="hidden" name="vads_action_mode" value="INTERACTIVE" />
<input type="hidden" name="vads_amount" value="2990" /> 
<input type="hidden" name="vads_capture_delay" value="0" /> 
<input type="hidden" name="vads_ctx_mode" value="TEST" /> 
<input type="hidden" name="vads_currency" value="978" /> 
<input type="hidden" name="vads_cust_country" value="FR" />
<input type="hidden" name="vads_cust_cell_phone" value="0612345678" />
<input type="hidden" name="vads_cust_email" value="mymail@example.com" />
<input type="hidden" name="vads_cust_first_name" value="Paul" /> 
<input type="hidden" name="vads_cust_last_name" value="Juve" /> 
<input type="hidden" name="vads_cust_title" value="Mr" /> 
<input type="hidden" name="vads_page_action" value="PAYMENT" />
<input type="hidden" name="vads_payment_cards" value="SDD" /> 
<input type="hidden" name="vads_payment_config" value="SINGLE" /> 
<input type="hidden" name="vads_site_id" value="12345678" /> 
<input type="hidden" name="vads_trans_date" value="20200516080441" /> 
<input type="hidden" name="vads_trans_id" value="3N2kj2" /> 
<input type="hidden" name="vads_validation_mode" value="0" /> 
<input type="hidden" name="vads_version" value="V2" />
<input type="hidden" name="signature" value="RROvv+fsP4U27wB2cqm67eDUv0gMXrvCSD05lKcWI28="/>
<input type="submit" name="pay" value="pay"/>
</form>

Categories

Tags

Creating a one-off direct debit request