Creating a one-click payment
This use case requires an already existing and valid mandate.
To make one-click 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 (cents for euro) E.g.: 3000 for €30.00 vads_ctx_mode Operating mode TEST or PRODUCTION vads_currency Currency euro code in compliance with the ISO 4217 standard. 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.: e-mail@example.com vads_identifier Unique Mandate Reference E.g.:
22e75ce992afe18da10
vads_page_action Action required to register a mandate and make a payment PAYMENT vads_payment_cards Payment method SDD 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.: 20200526130412 vads_trans_id Transaction number E.g.: 3N2kj2 vads_version Version of the exchange protocol V2 - Populate the vads_identifier field with the already existing and valid mandate identifier (UMR).
- 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).