Transmitting buyer details

In the payment form, the merchant must indicate whether he/she desires to submit order details (order number, description, contents of the cart, etc.). To trigger one or several actions depending on the contents of the buyer's cart, the cart details must be transmitted via your payment form.

It can be viewed in the Back Office by consulting the transaction details (Shopping cart tab).

  1. Use the fields required for your use case (see chapter Generating a payment form of the Payment Form Implementation Guide available here ) to create your payment form.
  2. Use the optional fields presented below according to your requirements. These fields will be sent back with the response and will include the value transmitted in the form.
    Table 1. Field list - Order details
    Field name Description
    vads_order_id Order ID.
    vads_order_info Order description.
    vads_order_info2 Order description.
    vads_order_info3 Order description.
    vads_nb_products Number of items.
    vads_product_labelN Item name. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
    vads_product_amountN Item amount. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
    vads_product_typeN Item type. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
    vads_product_refN Item reference. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
    vads_product_qtyN Quantity of items. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
  3. Populate vads_nb_products with the number of items in the cart.
    Note:
    This field must be populated for the cart to be taken into account.
  4. Populate vads_product_amountN with the amount of all the items in the cart in the smallest currency unit.
    0 corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
  5. Populate vads_product_typeN with the value corresponding to the item type.
    0 corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
    Table 2. Values associated with vads_product_typeN
    Value Description
    FOOD_AND_GROCERY Food and grocery
    AUTOMOTIVE Cars / Moto
    ENTERTAINMENT Entertainment / Culture
    HOME_AND_GARDEN Home and gardening
    HOME_APPLIANCE Household appliances
    AUCTION_AND_GROUP_BUYING Auctions and group purchasing
    FLOWERS_AND_GIFTS| Flowers and presents
    COMPUTER_AND_SOFTWARE Computers and software
    HEALTH_AND_BEAUTY Health and beauty
    SERVICE_FOR_INDIVIDUAL Services for individuals
    SERVICE_FOR_BUSINESS Services for companies
    SPORTS Sports
    CLOTHING_AND_ACCESSORIES Clothes and accessories
    TRAVEL Travel
    HOME_AUDIO_PHOTO_VIDEO Sound, image and video
    TELEPHONY Telephony
  6. Populate vads_product_labelN with the index of each item in the cart.
    0 corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
  7. Populate vads_product_qtyN with the quantity of each item in the cart.
    0 corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
  8. Populate vads_product_refN with the reference of each item in the cart.
    0 corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
  9. Verify the value of thevads_amount field. It must correspond to the total amount of the order.
  10. Compute the value of the signature field using all the fields of your form starting with vads_ (see chapter Computing the signature of the Payment Form Implementation Guide available here )).