Creating a 'Payment with option for the cardholder to create a token’ form
Use case: offer the possibility to create a token during a payment.
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 ASK_REGISTER_PAY vads_amount Payment amount (in the smallest currency unit) n..12 E.g.: 3000 for 30,00 EUR vads_ctx_mode Operating mode. enum TEST or PRODUCTION vads_currency Code of the currency used for the payment. n3 E.g.: 978 for euro (EUR) vads_cust_email Buyer’s e-mail address. ans..150 E.g.: firstname.lastname@example.org vads_action_mode Acquisition mode for payment method data. enum INTERACTIVE 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 E.g.: 20190501130025 vads_trans_id Unique ID of a transaction. n6 E.g.: 123456 vads_version Version of the exchange protocol. string V2
Use the vads_identifier field if you wish to generate the identifier of the token associated with the payment method.
The token format must not be an..32. This format is reserved for tokens generated by the payment gateway.
If you have activated the detection of token uniqueness, the value of the vads_identifier field transmitted in the form can be different from the one present in the notification if the payment method is already associated with another token.
- Add optional fields according to your requirements (see chapter Using additional features).
- Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature).
The list of fields returned in the notification is described in the chapter Payment with the token creation option for the cardholder.