Creating a payment request with registration of the electronic meal voucher

  1. Use all the fields presented in the table below to create your 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.

    • APETIZ for 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 with optional registration of the electronic meal voucher card.


      Payment with mandatory registration of the electronic meal voucher card.

    vads_cust_email Buyer's e-mail address. enum E.g.:
    vads_ctx_mode Operating mode. enum TEST or PRODUCTION
    vads_action_mode Acquisition mode for payment method data. enum INTERACTIVE
    vads_amount Payment amount (in the smallest currency unit) n..12 E.g.: 5124 for 51.24 euros
    vads_currency Country code of the card in compliance with the ISO 4217 standard n3 978 for Euro
    vads_acquirer_transient_data Amount payable by Titre-Restaurant card (in the smallest currency unit) json Example for an eligible amount of €17.25:

    vads_acquirer_transient_data ={"CONECS":{"eligibleAmount":"1725"}}

    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.: 20170501130025
    vads_version Version of the exchange protocol. string V2
    vads_capture_delay Capture delay n..3 0
    vads_validation_mode Validation mode enum 0 (Automatic)

    Signature guaranteeing the integrity of the requests exchanged between the merchant website and the payment gateway.


    See Computing the signature

  2. Add the optional fields described in the following chapters according to your requirements.
  3. Compute the value of the signature field using all the fields of your form that start with vads_ (see chapter Computing the signature).