Creating a 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. It is recommended to provide a different payment button for each payment method on the merchant website.
It is recommended not to leave the field empty.enum - APETIZ for Bimpli (ex Apetiz) Titres-Restaurant.
- SODEXO for Sodexo Titres-Restaurant.
- CHQ_DEJ for Chèque-Déjeuner Titres-Restaurant.
- CONECS for all Titres-Restaurant processed by the Conecs network.
- MASTERCARD for Titres-Restaurant outside the Conecs network.
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 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_version Version of the exchange protocol with the payment gateway enum V2 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 E.g.: 978 for euro (EUR) vads_acquirer_transient_data Amount payable by Titre-Restaurant card (in the smallest currency unit) json Example for an eligible amount of EUR 17.25: vads_acquirer_transient_data ={"CONECS":{"eligibleAmount":"1725"}}
vads_payment_config Payment type enum SINGLE 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_capture_delay Delay before capture in the bank. Any capture delay that exceeds 7 days will be ignored and reduced to 7 days. n..3 E.g.: 3 vads_validation_mode Validation mode n1 0 (automatic) or 1 (manual) signature Signature guaranteeing the integrity of the requests exchanged between the merchant website and the payment gateway.
ans - Add the optional fields described in the following chapters according to your requirements.
- Compute the value of the signature field using all the fields of your form that start with vads_ (see chapter Computing the signature).