Creating a 'Payment by token’ form
Use case: one-click payment (using an existing and valid token).
- Use all the fields presented in the table below to create your form.
Field name Description Format Value vads_page_action Action to perform enum PAYMENT vads_amount Payment amount in the smallest currency unit (cents for euro) n..12 E.g.: 4525 for EUR 45.25 vads_ctx_mode Mode of interaction with the payment gateway enum TEST or PRODUCTION 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_action_mode Acquisition mode for payment method data enum INTERACTIVE vads_identifier (unique) token associated with a payment method. ans..50 E.g.: MyTokenNote : two possible formats:
- an32: if the identifier is generated by the payment gateway
- ans..50: if the identifier is generated by the merchant.
vads_payment_config Payment type enum SINGLE vads_site_id Shop ID n8 E.g.: 12345678 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_version Version of the exchange protocol with the payment gateway enum V2 signature Signature guaranteeing the integrity of the requests exchanged between the merchant website and the payment gateway. ans..44 Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).
- Add optional fields according to your requirements (see chapter Using additional features).
The list of fields returned in the notification is described in the chapter Payment by token.