Transmitting order details
The merchant can indicate in their payment form if they wish to transfer the order details (order reference, description, shopping cart contents, etc.).
This information can be found in the transaction details in the Merchant Back Office (Shopping cart tab).
- Use optional fields according to your requirements. These fields will be returned with the response and will include the value transmitted in the form.
Field name Description Format Value vads_order_info Additional order info ans..255 E.g.: Door code 3125 vads_order_info2 Additional order info ans..255 E.g.: No elevator vads_order_info3 Additional order info ans..255 E.g.: Express vads_nb_products Number of items in the cart n..12 E.g.: 2 vads_product_ext_idN Product barcode on the merchant website. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.). E.g.: vads_product_ext_id0 = "0123654789123654789"
vads_product_ext_id1 = "0223654789123654789"
vads_product_labelN Item name. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.). ans..255 E.g.: vads_product_label0 = "Dated 3 days stay"
vads_product_label1 = "Private concert"
vads_product_amountN Item amount expressed in the smallest currency unit. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.). n..12 E.g.: vads_product_amount0 = "32150"
vads_product_amount1 = "10700"
vads_product_typeN Item type. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.). enum E.g.: vads_product_type0 = "TRAVEL"
vads_product_type1 = "ENTERTAINMENT"
vads_product_refN Item reference. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.). an..64 E.g.: vads_product_ref0 = "1002127784"
vads_product_ref1 = "1002127693"
vads_product_qtyN Item quantity. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.). n..12 E.g.: vads_product_qty0 = "1"
vads_product_qty1 = "1"
- Populate the vads_nb_products field with the number of items contained in the cart. This field becomes mandatory for the shopping cart to be taken into account.
When it is populated, the Shopping cart tab becomes available in the transaction details in the Merchant Back Office.
However, if the other fields that start with vads_product_ are not populated, the tab will not include any information. For this reason, when populating the vads_nb_products field, it becomes mandatory to populate the other fields that start with vads_product_.
- Populate the vads_product_amountN field with the amount for the items in the cart, using the smallest currency unit. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
- 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.).
Value Description FOOD_AND_GROCERY Food and grocery AUTOMOTIVE Cars / Moto ENTERTAINMENT Entertainment / Culture HOME_AND_GARDEN Home / Gardening HOME_APPLIANCE Household appliances AUCTION_AND_GROUP_BUYING Auctions / Group purchasing FLOWERS_AND_GIFTS Flowers / Presents COMPUTER_AND_SOFTWARE Computers / Software HEALTH_AND_BEAUTY Health / Beauty SERVICE_FOR_INDIVIDUAL Services for individuals SERVICE_FOR_BUSINESS Services for companies SPORTS Sports CLOTHING_AND_ACCESSORIES Clothes / Accessories TRAVEL Travel HOME_AUDIO_PHOTO_VIDEO Audio / Photo / Video TELEPHONY Telephony - Populate vads_product_labelN with the name of each item contained in the cart. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
- Populate vads_product_qtyN with the quantity of each item contained in the cart. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
- Populate vads_product_refN with the reference of each item contained in the cart. N corresponds to the index of the item (0 for the first one, 1 for the second one, etc.).
- Check the value of the vads_amount field. It must correspond to the total amount of the order.