Creating an UnionPay payment request
Use all the fields presented in the table below to create your payment form.
Field name Description Format Value vads_payment_cards Allows to force the card type to be used. Leave empty to let the Buyer choose between the eligible payment methods (depending on the currency, the minimum or maximum amount, the technical constraints) associated with the shop. enum
- UNION_PAY to directly call the UnionPay payment button.
- VISA;UNION_PAY to provide the choice between VISA and UnionPay.
vads_page_action Action to perform enum PAYMENT vads_amount Payment amount in the smallest currency unit (cents for euro). n..12 E.g.: 3000 for 30,00 EUR vads_ctx_mode Defines the 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 Possible values:
- 978 (EUR)
- 826 (GBP)
- 840 (USD)
vads_action_mode Acquisition mode for payment method data enum INTERACTIVE vads_cust_email Buyer’s e-mail address ans..150 E.g.: email@example.com vads_cust_country Country code in compliance with the ISO 3166 standard a2 Possible value: CN vads_cust_first_name First name ans..63 E.g.: Laurent vads_cust_last_name Name ans..63 E.g.: Durant 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.
Warning: this field is not case sensitive.
an6 E.g.: xrT15p vads_version Version of the exchange protocol with the payment gateway enum V2
- Add optional fields depending on your requirements (see chapter Using additional features of the Hosted Payment Page Implementation Guide available on our website).
- Compute the value of the signature field using all the fields of your form that start with vads_ (see chapter Computing the signature of the Hosted Payment Page Implementation Guide available on our website).