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.).

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) to create your payment form
  2. Use the optional fields 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_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 payment 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 Number of items. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
    vads_product_vatN Item tax. 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.
    When it is populated, the Shopping cart tab becomes available in transaction details in the Back Office.
    However, if the other fields starting with vads_product_ are not populated, the tab will not include any information. For this reason, when populating the vads_nb_products field, it is now mandatory to populate the other fields starting with vads_product_
  4. Populate vads_product_amountN with the amount of all the items in the cart in the smallest currency unit.N 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.N 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.N 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.N 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.N 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).