Creating a FullCB 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 - FULLCB3Xto directly call the 3 installments CB payment button.
- FULLCB4X to directly call the 4 installments CB payment button.
- VISA;FULLCB3X to offer the choice between VISA and 3 installments CB payment.
vads_page_action Action to perform enum PAYMENT vads_ctx_mode Mode of interaction with the payment gateway enum TEST orPRODUCTION 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_amount Payment amount in the smallest currency unit(cents for euro). n..12 E.g.: 4525 for EUR 45.25 vads_currency Numeric currency code to be used for the payment, in compliance with the ISO 4217 standard (numeric code). n3 Possible value: - 978 (EUR)
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 Respect the YYYYMMDDHHMMSS format
E.g.: 20200101130025vads_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 - Use the fields below to transmit the buyer details:
Field name Description Format Value vads_cust_status Status enum
PRIVATE: for a private individual COMPANY: for a company
vads_cust_title Buyer’s title an..63 E.g.: M vads_cust_last_name Last name ans..63 E.g.: Durant vads_cust_first_name First name ans..63 E.g.: Laurent vads_cust_address Postal address ans..255 E.g.: Rue de l’lnnovation vads_cust_city City an..128 E.g.: Labège vads_cust_zip Zip code an..64 E.g.: 31670 vads_cust_country Country code in compliance with the ISO 3166 alpha-2 standard a2 Possible value:FR vads_cust_email Buyer’s e-mail address ans..150 E.g.: abc@example.com vads_cust_cell_phone Cell phone number an..32 E.g.: 06 12 34 56 78 vads_cust_phone Phone number an..32 E.g.: 0467330222 - Use the fields below to transmit the shipping address
Field name Description Format Value vads_ship_to_status Allows to specify the type of the shipping address. enum
PRIVATE : for shipping to a private individual COMPANY : for shipping to a company
vads_ship_to_first_name First name ans..63 E.g.: Albert vads_ship_to_last_name Last name ans..63 E.g.: Durant vads_ship_to_street Postal address ans..255 E.g.: Rue Sainte Catherine vads_ship_to_street2 Address line 2 ans..255 vads_ship_to_zip Zip code an..64 E.g.: 33000 vads_ship_to_city City an..128 E.g.: Bordeaux vads_ship_to_country Country code in compliance with the ISO 3166 standard (required for triggering one or more actions if the Shipping country control profile is enabled). a2 E.g.: FR vads_ship_to_phone_num Phone number ans..32 E.g.: 0460030288 - Add optional fields according to your requirements (see Using additional features chapter of the Implementation Guide Hosted Payment Page).
- 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 Implementation Guide Hosted Payment Page available on our website).