Creation of the payment form
The merchant server receives a payment request from the mobile application and must transmit it to the payment gateway.
To do this, the merchant website will generate an HTML payment form that it will post to the payment gateway.
The integrity of shared data is guaranteed by the exchange of alphanumeric signatures between the payment gateway and the merchant server.
The merchant server will transmit the alphanumeric signature in the payment form (see chapter Computing the signature).
- Use all the fields of the table below to build your payment request.
Field name Description Format Value vads_site_id Shop ID n8 E.g.: 12345678 vads_currency Numeric currency code to be used for the payment, in compliance with the ISO 4217 standard (numeric code). n3 E.g.: 978 for euro (EUR) vads_amount Payment amount in the smallest currency unit(cents for euro). n..12 E.g.: 4525 for EUR 45.25 vads_cust_email Buyer’s e-mail address ans..150 E.g.: email@example.com vads_payment_cards Card type. String E.g.: VISA
(See the Implementation guide - Hosted Payment Form to view the list of possible values).
vads_order_id Order ID
Can contain uppercase or lowercase characters, numbers or hyphens ([A-Z] [a-z], 0-9, _, -).
ans..64 E.g.: 2-XQ001 vads_version Version of the exchange protocol with the payment gateway enum V2 vads_theme_config Allows to improve performance by disabling some elements of the payment page, such as the language selector, the logos at the bottom of the page, etc. map
vads_trans_date Date and time of the payment form in UTC format n14
Respect the YYYYMMDDHHMMSS formatE.g.: 20200101130025
vads_trans_id Transaction number.
Must be unique within the same day (from 00:00:00 UTC to 23:59:59 UTC).
Warning: this field is not case sensitive.
an6 E.g.: xrT15p vads_payment_config Payment type enum SINGLE for immediate payment
MULTI for payment in installments
vads_page_action Action to perform enum PAYMENT vads_ctx_mode Mode of interaction with the payment gateway enum TEST orPRODUCTION vads_action_mode Acquisition mode for payment method data enum INTERACTIVE signature Signature guaranteeing the integrity of the requests exchanged between the merchant website and the payment gateway. Its value calculation is described here: Computing the signature. ans44 E.g.:
- Use the fields below to manage the return to the mobile application at the end of the payment.
A payment can result in 4 different states:
Payment abandoned by the buyer.
You must associate a URL to each status:
Field name Description Format Value vads_url_success
URL where the buyer will be redirected in case of a successful transaction.
URL where the buyer will be redirected in case of a declined transaction.
URL where the buyer will be redirected in case of an abandoned or expired transaction (timeout).
URL where the buyer will be redirected in case of an error.
- Use the fields below to configure the time of redirection to the mobile application at the end of the payment:
Field name Description Format vads_redirect_success_timeout
Defines the delay before the redirection that follows an accepted payment.This delay is presented in seconds and must be between 0 and 300 sec.
Set this field to "0" to not display the payment ticket and to automatically redirect the buyer to the mobile application.
Defines the delay before the redirection that follows a declined payment.This delay is presented in seconds and must be between 0 and 300 sec.
Set this field to "0" to not display the payment rejection page and to automatically redirect the buyer to the mobile application.
- Add other optional fields according to your needs (see the following subsections).