Creating a FullCB payment request

  1. Use all the fields of the table below to create your payment form.
    Field name Description Format Value
    vads_payment_cards Allows to force the card type to use.

    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
    • FULLCB3X to 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 Defines the mode of interaction with the payment gateway. enum TEST or PRODUCTION
    vads_order_id Order ID ans..64 E.g.: 2-XQ001
    vads_amount Payment amount in the smallest currency unit (cents for euro). n..12 E.g.: 3000 for 30,00 EUR
    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 Card data acquisition mode 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.: 20170701130025
    vads_trans_id Transaction number n6 E.g.: 123456
    vads_version Version of the exchange protocol with the payment gateway enum V2
  2. Use the fields below to transmit the buyer details:
    Field name Description Format Value
    vads_cust_title Buyer’s title an..63 E.g.: M.
    vads_cust_last_name Name ans..63 E.g.: Durant
    vads_cust_first_name First name ans..63 E.g.: Laurent
    vads_cust_zip Zip code an..64 E.g.: 31670
    vads_cust_city City an..128 E.g.: Labège
    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
    vads_cust_country Country code in compliance with the ISO 3166 standard a2 Possible value: FR
    vads_cust_email Buyer’s e-mail address ans..150 E.g.: abc@example.com
    vads_cust_status Status

    enum

    PRIVATE: for a private individual

    COMPANY: for a company

  3. 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 Name ans..63 E.g.: Durant
    vads_ship_to_street Postal address ans..255 E.g.: Rue Sainte Catherine
    vads_ship_to_street2 Second line of the address 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. a2 E.g.: FR
    vads_ship_to_phone_num Phone number ans..32 E.g.: 0460030288
  4. Add optional fields depending on your requirements (see chapter Using additional features of the Hosted Payment Page Implementation guide available in our online document archive).
  5. 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 in our online document archive).