Cart
Handles shopping carts, including adding, removing, and updating items, as well as calculating totals.
Cart provides detailed information about selected items, including their name, quantity, price breakup, applied discounts, and any relevant attributes like size, product image, or tags. It also displays availability status, estimated shipping time, and seller information. This helps customers track their products throughout the order journey;
Operations
GET
# Get a cart
HEAD
# Get last modified timestamp of a cart
POST
# Add items to a cart
PUT
# Update cart items
PATCH
# Update store credits into cart and their items
PUT
# Delete a cart
GET
# Get a cart items count
PUT
# Update cart metadata
POST
# Create share cart link
GET
# List shared cart items
POST
# Update with shared items
Get details of a cart linked to a specific customer using a unique cart ID. It offers an overview of the items, quantities, prices, and other relevant information associated with the cart.
Parameters
id
string
The unique identifier of the cart.
i
boolean
Select `true` to retrieve all the items added in the cart.
b
boolean
Select `true` to retrieve the price breakup of cart items.
c
boolean
Select `true` to retrieve the cod charges in breakup of cart items.
assign_card_id
integer
Token of user's debit or credit card.
area_code
string
Customer servicable area_code.
buy_now
boolean
Select `true` to set/initialize buy now cart.
order_type
string
The order type of shipment HomeDelivery - If the customer wants the order home-delivered PickAtStore - If the customer wants the handover of an order at the store itself.
Enum
Response
200
Success. Returns a Cart object. Check the example shown below or refer `CartDetailResult` for more details.
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
Examples
Parameters
id:
"value"
i:
false
b:
false
c:
false
assign_card_id:
1
area_code:
"value"
buy_now:
false
order_type:
"value"
Was this section helpful?
GET
Response
Retrieve the last modified timestamp of the cart using unique cart ID. It indicates the most recent update made to the cart's content or properties.
Parameters
id
string
The unique identifier of the cart.
Response
200
Success. Receives last modifed timestamp in the header.
Header Items
Last-Modified
string
| date
Last-Modified Action on Cart
Examples
Parameters
id:
"value"
Was this section helpful?
HEAD
Response
Add product items to the customer's existing shopping cart. If there is no existing cart associated with the customer, it creates a new one and adds the items to it.
Parameters
i
boolean
Select `true` to retrieve all the items added in the cart.
b
boolean
Select `true` to retrieve the price breakup of cart items.
area_code
string
Customer servicable area_code.
buy_now
boolean
Select `true` to set/initialize buy now cart.
id
string
The unique identifier of the cart.
order_type
string
The order type of shipment HomeDelivery - If the customer wants the order home-delivered PickAtStore - If the customer wants the handover of an order at the store itself.
Enum
Request body
items
array of object (AddProductCart)
List of items detail which need to be added to cart like item id, item size, and item quantity.
Array of AddProductCart
article_assignment
object
Field to determine how article assignment should happen by article assignment level and strategy.
product_group_tags
array of string
Field to specify the product groups of the product that the user is trying to add in cart.
extra_meta
object
Extra meta data to be added at article level while add items to cart.
quantity
integer
| int32
Field to specify the product quantity that user wants to buy.
_custom_json
object
Field to add custom json at article level while add items to cart .
item_size
string
Field to determine size of the product.
store_id
integer
| int32
Unique identifier of the store selected by the user from which user want to buy a product.
display
string
Display field at article level .
article_id
string
Unique identifier of an article .
parent_item_identifiers
array of object
Fields to determine parent product of the product.
seller_id
integer
| int32
Unique idetifier of the seller selected by the user from which user want to buy a product .
pos
boolean
Filed to determine whether user is making request from pos or not.
item_id
integer
| int32
Unique identifier to identify product.
meta
object
Field to add meta data at article level.
seller_identifier
string
Add items using seller identifier for store os.
new_cart
boolean
Field to create to new cart whille user adds item to cart.
Response
200
Success. Returns a cart object as shown below. Refer `AddCartDetailResult` for more details.
AddCartDetailResult
message
string
Message of add to cart API response.
partial
boolean
When adding multiple items check if all added. True if only few are added.
cart
object (CartDetailResult)
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
success
boolean
True if all items are added successfully. False if partially added or not added.
result
object
Contains article related result info
items
array of object (CartItemInfo)
List of items that needs to be added in cart.
Array of CartItemInfo
item_id
integer
| int32
Item id of the product that needs to be added/updated/removed.
size
string
Item size of the product that needs to be added/updated/removed.
store_id
integer
| int32
Unique identifier of the store selected by the user from which user want to buy a product.
success
boolean
True if items are added/updated/removed successfully.
message
string
Message for added/updated/removed item.
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Update cart. Customers can modify added product attributes such as quantity and size, as well as remove items from the cart.
Parameters
id
string
The unique identifier of the cart.
i
boolean
Select `true` to retrieve all the items added in the cart.
b
boolean
Select `true` to retrieve the price breakup of cart items.
area_code
string
Customer servicable area_code.
buy_now
boolean
Select `true` to set/initialize buy now cart.
cart_type
string
The type of cart.
order_type
string
The order type of shipment HomeDelivery - If the customer wants the order home-delivered PickAtStore - If the customer wants the handover of an order at the store itself.
Enum
Request body
items
array of object (UpdateProductCart)
List items data that needs to be updated in cart.
Array of UpdateProductCart
extra_meta
object
Field to update extra meta of the product in cart.
_custom_json
object
Field to update custom json of the product in cart.
quantity
integer
| int32
Field to update the quantity of the item in cart.
item_size
string
Field to update the size of the product in cart.
item_index
integer
| int32
Item index determines on which index the product falls to be updated.
identifiers
object (CartProductIdentifer)
Required
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
article_id
string
Article id of the product in cart.
parent_item_identifiers
object
Field to update parent product of the item in cart.
item_id
integer
| int32
Item id of the product that needs to be updated.
meta
object
Field to update meta of the item in cart.
free_gift_items
array of object (FreeGiftItemCreation)
List of free gift items with updated sizes.
Array of FreeGiftItemCreation
promotion_id
string
Required
Unique identifier of the free gift promotion.
item_id
string
Required
Unique identifier of the selected free gift item.
item_size
string
Required
Size of the selected free gift item.
operation
string
Required
Field to determine if item to be removed from cart or it needs to be updated.
Enum
Response
200
Success. Updates and returns a cart object as shown below. Refer `UpdateCartDetailResult` for more details.
UpdateCartDetailResult
message
string
Message of update cart API response.
cart
object (CartDetailResult)
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
success
boolean
True if all items are added successfully. False if partially added or not added.
result
object
Contains article related result info
items
array of object (CartItemInfo)
List of items that needs to be updated in cart.
Array of CartItemInfo
item_id
integer
| int32
Item id of the product that needs to be added/updated/removed.
size
string
Item size of the product that needs to be added/updated/removed.
store_id
integer
| int32
Unique identifier of the store selected by the user from which user want to buy a product.
success
boolean
True if items are added/updated/removed successfully.
message
string
Message for added/updated/removed item.
Examples
Parameters
Parameters are not required.
Was this section helpful?
PUT
Response
Update cart. Customers can adjust the cart breakup by applying or removing store credits as needed.
Parameters
id
string
The unique identifier of the cart.
i
boolean
Select `true` to retrieve all the items added in the cart.
b
boolean
Select `true` to retrieve the price breakup of cart items.
buy_now
boolean
Select `true` to set/initialize buy now cart.
cart_type
string
The type of cart.
Request body
store_credit
boolean
Required
Field to determine if store credits needs to apply on cart or not.
Response
200
Success. Updates and returns a cart object as shown below. Refer `UpdateCartDetailResult` for more details.
UpdateCartDetailResult
message
string
Message of update cart API response.
cart
object (CartDetailResult)
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
success
boolean
True if all items are added successfully. False if partially added or not added.
result
object
Contains article related result info
items
array of object (CartItemInfo)
List of items that needs to be updated in cart.
Array of CartItemInfo
item_id
integer
| int32
Item id of the product that needs to be added/updated/removed.
size
string
Item size of the product that needs to be added/updated/removed.
store_id
integer
| int32
Unique identifier of the store selected by the user from which user want to buy a product.
success
boolean
True if items are added/updated/removed successfully.
message
string
Message for added/updated/removed item.
Examples
Parameters
Parameters are not required.
Was this section helpful?
PATCH
Response
Delete all items from the user's cart and resets it to its initial state, providing a clean slate for new selections.
Parameters
id
string
The unique identifier of the cart.
Response
200
Success. Returns whether the cart has been deleted or not.
DeleteCartDetailResult
message
string
Message for delete cart response.
success
boolean
True if cart is archived successfully. False if not archived.
Examples
Parameters
id:
"value"
Was this section helpful?
PUT
Response
Parameters
id
string
The unique identifier of the cart.
buy_now
boolean
Boolean value to get buy_now cart.
Response
200
Success. Returns the total count of items in a user's cart.
CartItemCountResult
user_cart_items_count
integer
| int32
Item count present in cart.
Examples
Parameters
id:
"value"
buy_now:
false
Was this section helpful?
GET
Response
Update metadata associated with a cart, which includes customer preferences, delivery instructions, or any special requirements related to the cart items.
Parameters
id
string
The unique identifier of the cart.
buy_now
boolean
Whether to get buy_now cart.
Request body
delivery_slots
object
Delivery slots details includes article level time slot when the shipment can be delivered.
gift_details
object (ArticleGiftDetail)
ArticleGiftDetail
article_id
object (GiftDetail)
GiftDetail
is_gift_applied
boolean
Is gift applied flag which determines if this is a gift oder not.
gift_message
string
Gift message for the one while receive the delivery of the order with this message.
pick_up_customer_details
object
Customer contact details for customer pickup at store.
checkout_mode
string
Checkout mode of user cart.
comment
string
Comment message to be added in user cart.
gstin
string
GSTIN number to be added in user cart.
custom_cart_meta
object
Custom cart meta json to be added in order meta which can be further received in cart API response and order meta in order detail API or webhook.
Response
200
400
Returns a message indicating the success of cart meta updation as shown below.
CartMetaResult
message
string
Detailed message.
is_valid
boolean
Whether added meta was vaild.
Examples
Parameters
id:
"value"
buy_now:
false
body:
body
Was this section helpful?
PUT
Response
Checkout refers to the final stage of the purchasing process where the customer completes their transaction by paying for the selected items and providing necessary shipping and payment information. During checkout, users review their cart contents, enter billing and shipping addresses, choose payment methods, and confirm their order. It's the pivotal moment when the transaction is finalized, and the goods are prepared for delivery to the customer's designated address.
Operations
POST
# Checkout cart
The checkout cart initiates the order creation process based on the items in the user’s cart, their selected address, and chosen payment methods. It also supports multiple payment method options and revalidates the cart details to ensure a secure and seamless order placement.
Parameters
buy_now
boolean
This indicates the type of cart to checkout.
cart_type
string
The type of cart.
Request body
custom_meta
array of object (CartCheckoutCustomMeta)
Custom meta data to be added in order.
Array of CartCheckoutCustomMeta
key
string
Required
Key name of custom meta.
value
string
Required
Value to be added in key.
customer_details
object (CustomerDetails)
CustomerDetails
email
string
Email address of the customer to be added in customer detail while checkout.
mobile
string
Required
Mobile number of customer to be added in customer detail while checkout.
name
string
Name of customer to be added in customer detail while checkout.
merchant_code
string
Merchant code of the payment mode selected to do the payment.
cart_id
string
Cart id of the user cart.
id
string
Nullable
Cart id of the user cart.
payment_auto_confirm
boolean
Payment auto confirm flag if payment need not to be collected from user.
payment_methods
array of object (PaymentMethod)
Required
Payment methods list used to make the payment.
Array of PaymentMethod
payment_meta
object (PaymentMeta)
Required
PaymentMeta
merchant_code
string
Merchant code of the payment mode selected to do the payment.
type
string
Type of card if payment mode is card to do the payment.
payment_gateway
string
Payment gateway used to do the payment.
payment_identifier
string
Nullable
Payment identifier of the payment mode selected to do the payment.
mode
string
Required
Payment mode of payment method used to make payment.
payment
string
Payment name of payment method used to make payment.
amount
number
| float
Nullable
Amount of the payment mode to be paid.
name
string
Name of the payment mode used to make payment.
payment_extra_identifiers
object
Payment extra identifier for the payment mode to do the payment.
payment_mode
string
Required
Payment mode of the payment selected to do the payment.
aggregator
string
Aggregator of payment mode to do the payment.
address_id
string
Address id of the user where the order to be delivered.
callback_url
string
Nullable
Callback url after payment received/failed.
Default Value : null
delivery_address
object
Delivery address data which includes customer address, customer phone, customer email, customer pincode, customer landmark and customer name.
staff
object (StaffCheckout)
StaffCheckout
employee_code
string
Employee code of staff who does checkout on behalf of customer.
user
string
Required
User id of the employee who does checkout on behalf of customer.
last_name
string
Required
Last name of staff employee who does checkout on behalf of customer.
first_name
string
Required
First name of staff emplyee who does checkout on behalf of customer.
_id
string
Required
Id of staff who does checkout on behalf of customer.
order_type
string
Order type of the order being placed like pickAtStore or HomeDelivery.
Enum
ordering_store
integer
| int32
Nullable
Ordering store id of the store from which the order is getting placed.
extra_meta
object
Extra meta to be added while checkout in order.
payment_identifier
string
Nullable
Payment identifier of the payment mode selected to do the payment.
billing_address
object
Billing address json which includes customer address, customer phone, customer email, customer pincode, customer landmark and customer name.
payment_params
object
Nullable
Payment params which includes payment identifier and merchant code.
billing_address_id
string
Billing address id selected by user on which shipment bill to be generated.
meta
object
Meta data sent while checkout v2.
iin
string
Issuer Identification Number' number of card if payment mode is card to do the payment.
network
string
Network of card if payment mode is card to do the payment.
type
string
Type of cart if payment mode is card to do the payment.
card_id
string
Saved card id if payment mode is card to do the payment.
success_callback_url
string
Nullable
Success callback url to be redirected after payment received
failure_callback_url
string
Nullable
Failure callback url to be redirected after payment failed
order_tags
array of object (OrderTag)
Order tags used to identify specific type of order which is tagged using order tags
Array of OrderTag
display_text
string
Display text for order tag
slug
string
Slug to be used for tagging order with any unique value
Response
200
400
Success. Returns the status of cart checkout. Refer `CartCheckoutResultSchema` for more details.
CartCheckoutResult
payment_confirm_url
string
Payment confirm url used to redirect after payment is confirmed.
app_intercept_url
string
App intercept url which is used to redirect on app after payment in confirmed/failed.
success
boolean
Success flag of cart checkout API response.
callback_url
string
Callback url to be redirected after payment received/failed.
message
string
Message of the cart checkout v2 API response.
data
object
Data of the user cart checkout includes cart data, address, user id, order type etc.
order_id
string
Order id generated after placing order.
cart
object (CheckCart)
CheckCart
checkout_mode
string
Checkout mode of user cart.
user_type
string
User type of the cart who places the order.
cod_message
string
Cash On Delivery message for the order placed.
cart_id
integer
| int32
Cart id of the user cart for which the order placed.
is_valid
boolean
Valid flag fotr the checkout response if order placed was valid.
delivery_charges
number
| float
Delivery charges of the order placed via checkout API.
id
string
Cart id of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
error_message
string
Error details if any error occurs which includes type of error, error code and error message.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message added in cart after order placed.
items
array of object (CartProductInfo)
Items details in cart after order placed.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
uid
string
Cart id of user cart.
delivery_charge_order_value
integer
| int32
Delivery charge order value.
delivery_charge_info
string
Delivery charge in information message on shipment.
cod_available
boolean
Whether Cash On Delivery available.
success
boolean
Success flag of checkout cart API response.
store_code
string
Store code from which the order placed.
message
string
Message of the cart checkout API response.
gstin
string
GSTIN number added in cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
order_id
string
Order id generated after placing order.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
store_emps
array of object
Store employees data.
coupon_text
string
Coupon text of the applied coupon on order placed.
buy_now
boolean
Buy now flag of user cart.
cod_charges
number
| float
Cash On Delivery charges of the user cart.
custom_cart_meta
object
Custom cart meta details added in cart.
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Coupons are promotional tools offered by businesses to customers, providing discounts, incentives, or special offers on purchases. Their aim is to attract customers, increase sales, encourage repeat purchases, and promote customer loyalty. Various types of coupons include: X Percentage Value: Offers a discount based on a percentage of the total purchase value. Example: Get 15% off your entire order. X Amount Value: Provides a fixed discount amount regardless of the total purchase value. Example: Save Rs.20 on your purchase. Bundle Percentage Discount: Discounts applied when purchasing a specific combination or quantity of items. Example: Buy 2 shirts and get 20% off each. Bundle Amount Percentage Discount: Similar to bundle percentage discount, but the discount is applied to a specific amount spent. Example: Spend Rs.100 on shoes and receive 25% off your entire order. Buy X Items Get Y Items Free: Offers a certain number of items for free when a specified quantity is purchased. Example: Buy 2 pairs of socks and get 1 pair free. Buy X Items at Absolute Amount: Allows customers to purchase a set number of items at a fixed price. Example: Buy 3 t-shirts for Rs. 250.
Operations
GET
# List available coupons
POST
# Apply coupon
DEL
# Remove coupon
GET
# List bulk discounts
GET
# Validate applied coupon
List all available coupons that customer can apply to their carts. It provides details about each coupon, including its code, discount amount, and applicable conditions.
Parameters
id
string
The unique identifier of the cart.
buy_now
boolean
Whether to get buy_now cart.
slug
string
Product slug to fetch the available coupons.
store_id
string
Unique identifier of a store.
Response
200
Success. Returns a coupon object which has a list of all the eligible coupons. Refer `GetCouponResult` for more details.
GetCouponResult
page
object (PageCoupon)
PageCoupon
total_item_count
integer
| int32
Total coupons are available for the cart.
has_next
boolean
Denotes if next page of coupon is available.
total
integer
| int32
Total pages of coupon availalbe.
current
integer
| int32
Current page number.
has_previous
boolean
Denotes if previous page of the coupon is available.
available_coupon_list
array of object (Coupon)
List of available coupon which can be applied on cart.
Array of Coupon
coupon_amount
number
| float
The amount based on cart value.
coupon_value
number
| float
Coupon value of the coupon applied to cart.
title
string
Coupon Title of the coupon applied denotes name of the coupon.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
sub_title
string
Coupon subtitle of the coupon applied to cart which is used to display.
expires_on
string
Message to display to user for expiry of the coupon .
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
coupon_code
string
Coupon code of the coupon applied on cart.
is_applicable
boolean
Flag to determine where the coupon is applicable to cart or not.
description
string
Nullable
Coupon description of the coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
start_date
string
| date-time
Nullable
Start date of the coupon when the coupon will be live for the users to apply on cart.
end_date
string
| date-time
Nullable
End date of the coupon on which the coupon expires.
coupon_applicable_message
string
Message which is used to display to the customer if the coupon is applied successfully.
offer_text
string
Offer text of the coupon which highligts coupon offer defined while creating coupon .
is_bank_offer
boolean
Bank offer flag for the coupon if the coupon is applicable for only if payment done by bank or mode specified in coupon.
Examples
Parameters
id:
"value"
buy_now:
false
slug:
"value"
store_id:
"value"
Was this section helpful?
GET
Response
Parameters
i
boolean
Select `true` to retrieve all the items added in the cart.
b
boolean
Select `true` to retrieve the price breakup of cart items.
p
boolean
Select `true` for getting a payment option in response.
id
string
The unique identifier of the cart.
buy_now
boolean
This is boolean to get buy_now cart.
cart_type
string
The type of cart.
Request body
coupon_code
string
Required
Coupon code to be applied.
Response
201
Success. Returns coupons applied to the cart along with item details and price breakup. Refer `CartDetailResult` for more details.
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
Examples
Parameters
i:
false
b:
false
p:
false
id:
"value"
buy_now:
false
cart_type:
"value"
body:
body
Was this section helpful?
POST
Response
Remove an applied coupon from the customer's cart, thereby removing the associated discount from the cart total.
Parameters
id
string
The unique identifier of the cart.
buy_now
boolean
Wheter to get buy_now cart.
Response
200
Success. Returns coupons removed from the cart along with item details and price breakup. Refer `CartDetailResult` for more details.
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
Examples
Parameters
id:
"value"
buy_now:
false
Was this section helpful?
DEL
Response
List offer discounts with information about quantity and seller. One offer is marked with a "best" flag, indicating it as the best offer among the list.
Parameters
item_id
integer
The Item ID of the product.
article_id
string
Article Mongo ID.
uid
integer
UID of the product.
slug
string
A short, human-readable, URL-friendly identifier of a product.
Response
200
Success. Returns a data object containing the seller details and available offers (if exists) on bulk products. Refer `BulkPriceResult` for more details.
BulkPriceResult
data
array of object (BulkPriceOffer)
Actual data to be in response consist of offers from multiple seller.
Array of BulkPriceOffer
offers
array of object (OfferItem)
Offers is the list of Offer item, which consists of margin percentage, price, quantity, offer type and offer price.
Array of OfferItem
price
object (OfferPrice)
OfferPrice
currency_symbol
string
Currency symbol for currency.
bulk_effective
number
| float
Discounted per unit price for current offer object.
currency_code
string
The currency code for an offer price is the three-letter code that corresponds to the currency in which the offer price is denominated.
effective
integer
| int32
The "effective price" is the actual price paid by the consumer after accounting for product discounts. It represents the true cost of a product or service after all adjustments have been made.
marked
integer
| int32
The price at which the product is sold to the end consumer, typically the original price before discounts.
margin
integer
| int32
Percentage value of discount.
quantity
integer
| int32
Quantity on which offer is applicable.
best
boolean
Is true for best offer from all offers present for all sellers.
total
number
| float
Total price of offer quantity with discount.
auto_applied
boolean
Whether offer discount is auto applied in cart.
type
string
Type of the offer.
seller
object (OfferSeller)
OfferSeller
uid
integer
| int32
Unique identifier for a seller.
name
string
Name of a seller.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Validate the applicability of a coupon code for the selected payment mode for the existing cart. This ensures the coupon's validity before proceeding with the payment process, enhancing user experience and preventing potential errors during transactions.
Parameters
id
string
The unique identifier of the cart.
buy_now
boolean
Whether to get buy_now cart.
address_id
string
ID allotted to an address.
payment_mode
string
Payment mode selected by the customer.
payment_identifier
string
Identifier of payment like ICIC, PAYTM.
aggregator_name
string
Payment gateway identifier.
merchant_code
string
Identifier used by payment gateway for a given payment mode, e.g. NB_ICIC, PAYTM.
iin
string
Debit/Credit card prefix (first 6 digit).
network
string
Credit/Debit card issuer, e.g. VISA, MASTERCARD, RUPAY.
type
string
Card type, e.g. Credit, Debit.
card_id
string
Saved card token reference id.
cart_type
string
Type of the cart.
Response
200
Success. Returns a success message and the coupon validity. Refer `PaymentCouponValidate` for more details.
PaymentCouponValidate
message
string
Payment mode valid message for coupon.
coupon_validity
object (CouponValidity)
CouponValidity
title
string
Coupon Title of the coupon applied.
discount
number
| float
Coupon discount value of the coupon applied.
next_validation_required
boolean
Nullable
Flag for coupon validation required on next page or not.
valid
boolean
Valid flag which denotes if the applied coupon is valid or not.
display_message_en
string
Nullable
Display message for coupon validity.
code
string
Nullable
Coupon code of the coupon applied.
error_en
string
Nullable
Error message for the selected payment mode.
success
boolean
Success flag of coupon payment mode validity API response.
Examples
Parameters
id:
"value"
buy_now:
false
address_id:
"value"
payment_mode:
"value"
payment_identifier:
"value"
aggregator_name:
"value"
merchant_code:
"value"
iin:
"value"
network:
"value"
type:
"value"
card_id:
"value"
cart_type:
"value"
Was this section helpful?
GET
Response
A customer's address refers to the address where the ordered product is to be delivered. It usually includes details such as the recipient's name, contact, street address, city, state or province, PIN code or ZIP code, and country. Each customer can have multiple addresses associated with them. Storing addresses includes validating the address based on the country and its unique identifiers like PIN code, ZIP code, or area code,
Operations
GET
# Get a list of addresses for a customer
POST
# Creates a new address for a customer
GET
# Get details for a single customer address
PUT
# Updates an existing customer address
DEL
# Removes an address from a customer's address list
POST
# Select customer address for order processing
List all addresses saved by the customer, simplifying the checkout process by offering pre-saved address options for delivery.
Parameters
cart_id
string
The unique identifier of the user cart.
buy_now
boolean
Whether to get buy_now cart.
mobile_no
string
Mobile number of the customer.
checkout_mode
string
Option to checkout for self or for others.
tags
string
Tag given to an address, e.g. work, home, office, shop.
is_default
boolean
Select `true` to fetch the default address.
Response
200
Success. Returns an Address object containing a list of address saved in the account. Refer `GetAddressesResult` for more details.
GetAddressesResult
pii_masking
boolean
Personally Identifiable Information masking flag to denote if the user data in address is masked or not.
address
array of object (Address)
Address description for address data.
Array of Address
country_iso_code
string
Country iso code for address.
area
string
Area description for address.
phone
string
Phone number for address.
country_phone_code
string
Country phone code for address.
checkout_mode
string
Checkout mode of address on which address to be used for which checkout mode of cart.
address
string
Address description for address data.
area_code_slug
string
Area code slug for address. example pincode is slug for India.
geo_location
object (GeoLocation)
GeoLocation
latitude
number
| float
Latitude coordinate for address.
Default Value : 0
longitude
number
| float
Longitude coordinate for address.
Default Value : 0
id
string
Id of the address.
_custom_json
object
Custom json of the address.
city
string
City of the address.
sector
string
Sector of the address.
state_code
string
State code for address.
created_by_user_id
string
Created by user id of address.
landmark
string
Landmark of address.
user_id
string
User id of address for which address is created.
name
string
Name of person in address data to whom it belongs to.
google_map_point
object
Google map point of the address.
is_active
boolean
States whether address is active or not.
tags
array of string
Tags of address from which it can be identified.
country_code
string
Country code of address.
address_type
string
Address type of address.
country
string
Country of address.
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected.
area_code
string
Area code of the address.
email
string
Email address for address data.
state
string
State of the address.
meta
object
Metadata of the address.
validation_config
object (ValidationConfig)
ValidationConfig
address_max_limit
integer
| int32
The maximum number of addresses a user can have.
user_address_count
integer
| int32
The total number of addresses saved by a user.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Add a new address to their cart to save details such as name, email, contact information, and address.
Parameters
No Parameters
Request body
country_iso_code
string
Country iso code for address.
area
string
Area description for address.
phone
string
Phone number for address.
country_phone_code
string
Country phone code for address.
checkout_mode
string
Checkout mode of address on which address to be used for which checkout mode of cart.
address
string
Address description for address data.
area_code_slug
string
Area code slug for address. example pincode is slug for India.
geo_location
object (GeoLocation)
GeoLocation
latitude
number
| float
Latitude coordinate for address.
Default Value : 0
longitude
number
| float
Longitude coordinate for address.
Default Value : 0
id
string
Id of the address.
_custom_json
object
Custom json of the address.
city
string
City of the address.
sector
string
Sector of the address.
state_code
string
State code for address.
created_by_user_id
string
Created by user id of address.
landmark
string
Landmark of address.
user_id
string
User id of address for which address is created.
name
string
Name of person in address data to whom it belongs to.
google_map_point
object
Google map point of the address.
is_active
boolean
States whether address is active or not.
tags
array of string
Tags of address from which it can be identified.
country_code
string
Country code of address.
address_type
string
Address type of address.
country
string
Country of address.
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected.
area_code
string
Area code of the address.
email
string
Email address for address data.
state
string
State of the address.
meta
object
Metadata of the address.
Response
200
422
Success. Returns the address ID, a flag whether the address is set as default, and a success message. Refer `SaveAddressResult` for more details.
SaveAddressResult
id
string
Id of the address.
success
boolean
Success flag of save address Result.
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected.
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Get a specific customer address stored in the system by providing its unique identifier. This API provides detailed information about the address, including the recipient's name, address, city, postal code, and other relevant details.
Parameters
id
string
Required
ID allotted to the selected address.
cart_id
string
The unique identifier of the cart.
buy_now
boolean
This is boolean to get buy_now cart.
mobile_no
string
Mobile number of the customer.
checkout_mode
string
Option to checkout for self or for others.
tags
string
Tag given to an address, e.g. work, home, office, shop.
is_default
boolean
This is a boolean value. Select `true` to fetch the default address.
Response
200
Success. Returns an Address object containing a list of address saved in the account. Refer `Address` for more details.
Address
country_iso_code
string
Country iso code for address.
area
string
Area description for address.
phone
string
Phone number for address.
country_phone_code
string
Country phone code for address.
checkout_mode
string
Checkout mode of address on which address to be used for which checkout mode of cart.
address
string
Address description for address data.
area_code_slug
string
Area code slug for address. example pincode is slug for India.
geo_location
object (GeoLocation)
GeoLocation
latitude
number
| float
Latitude coordinate for address.
Default Value : 0
longitude
number
| float
Longitude coordinate for address.
Default Value : 0
id
string
Id of the address.
_custom_json
object
Custom json of the address.
city
string
City of the address.
sector
string
Sector of the address.
state_code
string
State code for address.
created_by_user_id
string
Created by user id of address.
landmark
string
Landmark of address.
user_id
string
User id of address for which address is created.
name
string
Name of person in address data to whom it belongs to.
google_map_point
object
Google map point of the address.
is_active
boolean
States whether address is active or not.
tags
array of string
Tags of address from which it can be identified.
country_code
string
Country code of address.
address_type
string
Address type of address.
country
string
Country of address.
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected.
area_code
string
Area code of the address.
email
string
Email address for address data.
state
string
State of the address.
meta
object
Metadata of the address.
Examples
Parameters
id:
"value"
cart_id:
"value"
buy_now:
false
mobile_no:
"value"
checkout_mode:
"value"
tags:
"value"
is_default:
false
Was this section helpful?
GET
Response
Customer can modify the details of a previously saved addresses.
Parameters
id
string
Required
ID allotted to the selected address.
Request body
country_iso_code
string
Country iso code for address.
area
string
Area description for address.
phone
string
Phone number for address.
country_phone_code
string
Country phone code for address.
checkout_mode
string
Checkout mode of address on which address to be used for which checkout mode of cart.
address
string
Address description for address data.
area_code_slug
string
Area code slug for address. example pincode is slug for India.
geo_location
object (GeoLocation)
GeoLocation
latitude
number
| float
Latitude coordinate for address.
Default Value : 0
longitude
number
| float
Longitude coordinate for address.
Default Value : 0
id
string
Id of the address.
_custom_json
object
Custom json of the address.
city
string
City of the address.
sector
string
Sector of the address.
state_code
string
State code for address.
created_by_user_id
string
Created by user id of address.
landmark
string
Landmark of address.
user_id
string
User id of address for which address is created.
name
string
Name of person in address data to whom it belongs to.
google_map_point
object
Google map point of the address.
is_active
boolean
States whether address is active or not.
tags
array of string
Tags of address from which it can be identified.
country_code
string
Country code of address.
address_type
string
Address type of address.
country
string
Country of address.
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected.
area_code
string
Area code of the address.
email
string
Email address for address data.
state
string
State of the address.
meta
object
Metadata of the address.
Response
201
Success. Returns the address ID and a message indicating a successful address updation.
UpdateAddressResult
is_updated
boolean
Updated flag for update address operation if the address updated or not.
id
string
ID of an address.
success
boolean
Success flag of update address response.
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected.
Examples
Parameters
id:
"value"
body:
body
Was this section helpful?
PUT
Response
Delete an existing customer address from the system.
Parameters
id
string
Required
ID allotted to the selected address.
Response
201
Returns a Status object indicating the success or failure of address deletion.
DeleteAddressResult
id
string
Id of the address.
is_deleted
boolean
Deleted flag in delete address response states whether the address was deleted or not.
Examples
Parameters
id:
"value"
Was this section helpful?
DEL
Response
Select an address from the saved customer addresses and validates the availability of items in the cart. Additionally, it verifies and updates the delivery promise based on the selected address.
Parameters
cart_id
string
The unique identifier of the cart.
buy_now
boolean
Whether to get buy_now cart.
i
boolean
Select `true` to retrieve all the items added in the cart.
b
boolean
Select `true` to retrieve the price breakup of cart items.
Request body
id
string
Address is selected by user on which shipment to be delivered.
billing_address_id
string
Billing address id selected by user on which shipment bill to be generated.
cart_id
string
Cart id of the user cart for which the select address operation performed.
Response
201
400
Success. Returns a Cart object as shown below. Refer `CartDetailResult` for more details. .
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
Examples
Parameters
cart_id:
"value"
buy_now:
false
i:
false
b:
false
body:
body
Was this section helpful?
POST
Response
Payment mode refers to the method used by customers to pay for their purchases during the checkout process. Payment modes typically include options such as credit card, debit card, digital wallets, bank transfer, cash on delivery (COD), and various online payment platforms like PayPal or Stripe. Customers select their preferred payment mode based on factors such as convenience, security, and availability. The chosen payment mode dictates how the transaction is processed and completed, ensuring a smooth and secure payment experience for the customer.
Operations
PUT
# Select payment mode
Select a preferred payment mode from available options during the cart checkout process to securely and efficiently complete their transaction.
Parameters
id
string
The unique identifier of the cart.
buy_now
boolean
Whether to get buy_now cart.
Request body
id
string
Cart id of the user cart for which the update cart payment operation performed.
payment_identifier
string
Nullable
Payment identifier of the payment mode selected to do the payment.
address_id
string
Address id of the user address selected to deliver the shipment.
merchant_code
string
Merchant code of the payment mode selected to do the payment.
aggregator_name
string
Aggregator name of the payment gateway.
payment_mode
string
Payment mode of the payment selected to do the payment.
Response
200
Success. Returns a Cart object as shown below. Refer `CartDetailResult` for more details.
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
Examples
Parameters
id:
"value"
buy_now:
false
body:
body
Was this section helpful?
PUT
Response
Promotion offers are special incentives or discounts provided to customers to encourage purchases or enhance their shopping experience. These offers can take various forms, such as percentage discounts, fixed-price discounts, free shipping, buy-one-get-one (BOGO) deals. Ladder pricing, also known as tiered pricing, refers to a pricing strategy where the price of a product varies depending on the quantity purchased or other specified criteria. With ladder pricing, customers are incentivized to buy more by offering discounts or reduced prices for larger quantities or higher purchase volumes. For example, a retailer might offer a discounted price per unit for purchasing 10 items instead of just one.
Operations
GET
# List available promotion offers
GET
# List ladder offers
GET
# Fetch available promotions payment offers
List all promotional offers available for the items in the cart, including details such as offer text, unique promotion ID, and validity period.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product.
page_size
integer
Number of offers to be fetched to show.
promotion_group
string
Type of promotion groups.
store_id
integer
Unique identifier of a store.
cart_type
string
The type of cart.
Response
200
400
Success. Returns a array containing the available offers (if exists) on product via promotions. Refer `PromotionOffersResult` for more details.
PromotionOffersResult
available_promotions
array of object (PromotionOffer)
Available promotion details which are available on product which includes promotion data like promotion id, promotion name, buy rules, discount rules validity dates etc.
Array of PromotionOffer
id
string
Promotion id of the promotion which is available on product.
buy_rules
object
Buy rules of promotion which is available on product.
offer_text
string
Offer title of the promotion which is available on product.
promotion_type
string
Promotion type of the promotion which is availalbe on product.
Enum
promotion_name
string
Name of the promotion which is available on product.
promotion_group
string
Group of the promotion which is available on product.
valid_till
string
| date-time
Datetime ISO String for promotion end date which is available on product.
discount_rules
array of object
Discount rules of promotions which is avaiable on product.
free_gift_items
array of object (FreeGiftItems)
Details of free gift items which included item id, brand name, item name, item slug, item price and item image url.
Array of FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
description
string
Offer details including T&C of the promotion which is avaiable on product.
Examples
Parameters
slug:
"value"
page_size:
1
promotion_group:
"value"
store_id:
1
cart_type:
"value"
Was this section helpful?
GET
Response
Get ladder offers associated for the items in the cart. Ladder offers provide discounts or special pricing based on item quantity, allowing users to benefit from bulk purchases or promotional deals.
Parameters
slug
string
Required
A short, human-readable, URL-friendly identifier of a product.
store_id
string
Store uid of assigned store on PDP page. If not passed default first created ladder will be returned.
promotion_id
string
Get ladder information of given promotion id explicitely.
page_size
integer
Number of offers to be fetched to show.
Response
200
400
Success. Returns a object containing the applicable ladder price offers (if exists) on product. Refer `PromotionOffersResult` for more details.
LadderPriceOffers
available_offers
array of object (LadderPriceOffer)
Available ladder promotions offers list.
Array of LadderPriceOffer
id
string
ID of the promotion.
buy_rules
object
Buy rules of ladder price promotion applicable on product.
calculate_on
string
If this ladder offer is to be calculated on MRP or ESP price.
offer_text
string
Offer title of ladder price promotion applicable on product.
promotion_group
string
Group of ladder price promotion applicable on product.
valid_till
string
| date-time
Datetime ISO String for promotion end date.
discount_rules
array of object
Discount rules of ladder price promotion applicable on product.
offer_prices
array of object (LadderOfferItem)
Offer prices for ladder price promotion applicable on product.
Array of LadderOfferItem
price
object (LadderPrice)
LadderPrice
currency_symbol
string
Currency symbol for currency of ladder price product.
offer_price
number
| float
Discounted per unit price for current offer object.
currency_code
string
Currency code for all amounts.
effective
integer
| int32
Current per unit price of product after existing deductions.
marked
integer
| int32
Original price of product.
margin
integer
| int32
Percentage value of discount.
max_quantity
integer
| int32
Minimum quantity upto which offer is applicable. If not present that offer is applicable on all quantities.
min_quantity
integer
| int32
Minimum quantity from which offer is applicable.
type
string
Offer type of the ladder promotion.
free_gift_items
array of object (FreeGiftItems)
Details of free gift items list.
Array of FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
description
string
Offer details including T&C of ladder price promotion applicable on product.
currency
object (CurrencyInfo)
CurrencyInfo
code
string
Currency code of ladder price promotion.
symbol
string
Currency symbol for currency of ladder price product.
Examples
Parameters
slug:
"value"
store_id:
"value"
promotion_id:
"value"
page_size:
1
Was this section helpful?
GET
Response
Use this API to get top 5 payment offers available for current product.
Parameters
id
string
Cart id of the user cart .
uid
integer
Cart uid of the user cart .
Response
200
400
Success. Returns a array containing the available offers (if exists) on product via promotions. Refer `PromotionPaymentOffersResult` for more details.
PromotionPaymentOffersResult
success
boolean
Success flag of get payment offers API response.
promotions
array of object (PromotionPaymentOffer)
List of promotions data which are applicable on cart/product.
Array of PromotionPaymentOffer
application_id
string
Application id on which the promotion was created.
buy_rules
array of object
Buy rules of promotions which denotes if the rules matches than only promotion is applicable.
calculate_on
string
Article Price on which promotion calculated like effective price or marked price.
description
string
Offer details including T&C of the promotion which is avaiable on cart.
discount_rules
array of object
Discount rules of promotions which is avaiable on cart.
id
string
Promotion id of the promotion which is available on cart.
offer_text
string
Offer title of the promotion which is available on cart.
promotion_group
string
Group promotion which is available on cart.
promotion_type
string
Promotion type of the promotion which is availalbe on cart.
Enum
promotion_name
string
Name of the promotion which is available on cart.
Examples
Parameters
id:
"value"
uid:
1
Was this section helpful?
GET
Response
Reward points are incentives given to customers as part of a loyalty program or promotional campaign. Users accumulate reward points through various activities, such as making purchases, referring friends, or engaging with the platform. Reward points can be redeemed for discounts.
Operations
POST
# Use reward points
Users can redeem their accumulated reward points and apply them to the items in their cart, thereby availing discounts on their current purchases.
Parameters
id
string
The unique identifier of the cart.
i
boolean
Select `true` to retrieve all the items added in the cart.
b
boolean
Select `true` to retrieve the price breakup of cart items.
buy_now
boolean
This is boolean to get buy_now cart.
Request body
points
boolean
Required
Points to be applied for cart.
Response
200
Success. Returns a Cart object. Check the example shown below or refer `CartDetailResult` for more details.
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart.
uid
string
Unique identifier of the user cart.
applied_promo_details
array of object (AppliedPromotion)
List of applied promotions data to cart which includes promotion id, promotion name, offer text, description, buy rules, discount rules and promotion type.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
checkout_mode
string
Checkout mode of user cart.
pan_no
string
Permanent Account Number of the user.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
id
string
Unique identifier of the user cart.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
comment
string
Comment message to be added in user cart.
items
array of object (CartProductInfo)
Items data list in user cart that includes item id, item size, store id, available sizes and rest of the item related data.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
delivery_charge_info
string
Delivery charge in information message on shipment .
common_config
object (CartCommonConfig)
CartCommonConfig
delivery_charges_config
object (DeliveryChargesConfig)
DeliveryChargesConfig
enabled
boolean
Delivery charge enabled for the cart or not.
charges
array of object (ChargesThreshold)
Charges applicable based on threshold.
Array of ChargesThreshold
charges
number
| float
Charges amount to be applied on cart.
threshold
number
| float
Threshold of cart value on which the charge should be applied .
coupon
object (CartDetailCoupon)
CartDetailCoupon
cashback_amount
number
| float
Fields denotes cashback amount applied to cart.
cashback_message_primary
string
Primary cashback message for coupon applied to cart.
cashback_message_secondary
string
Secondary cashback message for coupon applied to cart.
coupon_code
string
Coupon code to be applied to cart.
coupon_description
string
Coupon description of the coupon applied to cart.
coupon_id
string
Unique identifier of the coupon applied to cart.
coupon_subtitle
string
Coupon subtitle of the coupon applied to cart.
coupon_title
string
Coupon Title of the coupon applied.
coupon_type
string
Type of the coupon applied to cart.
coupon_value
number
| float
Value of the coupon applied to cart.
discount
number
| float
Total discount earned from coupon applied to cart.
is_applied
boolean
Flag to determine where the coupon is applied to cart or not.
is_valid
boolean
Determine where the coupon applied to cart is valid.
maximum_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
message
string
Coupon message of the coupon applied to cart.
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart.
message
string
Message of the get cart detail API response.
notification
object
Notification object which denotes notification data for user cart.
staff_user_id
string
Staff employee user id if cart is created by staff employee for the customer.
success
boolean
Success flag of get cart detail API response.
gstin
string
GSTIN added in user cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
coupon_text
string
Coupon text of coupon applied on cart.
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now.
pan_config
object
Pan card config states at what condition user should enter the pan card.
custom_cart_meta
object
Custom meta details added cart checkout API payload .
Examples
Parameters
id:
"value"
i:
false
b:
false
buy_now:
false
body:
body
Was this section helpful?
POST
Response
Shipment refers to the process of delivering purchased items from the seller's location to the customer’s designated address. Shipment details includes seller information, estimated delivery dates, item quantity, order type (Home Delivery or Digital) and other shipment meta information. Additionally, it provides details about the items included in the shipment.
Operations
GET
# List shipments
Get shipment details for the items in a cart, specific to the selected address. Shipment details include delivery promises, seller information, item details, and other relevant information.
Parameters
p
boolean
Select `true` for getting a payment option in response.
id
string
The unique identifier of the cart.
buy_now
boolean
This is boolean to get buy_now cart.
address_id
string
ID allotted to the selected address.
area_code
string
The PIN Code of the destination address, e.g. 400059.
order_type
string
The order type of shipment HomeDelivery - If the customer wants the order home-delivered PickAtStore - If the customer wants the handover of an order at the store itself. Digital - If the customer wants to buy digital voucher ( for jiogames ).
Enum
Response
200
Success. Returns delivery promise along with shipment details and price breakup. Refer `CartShipmentsResult` for more details.
CartShipmentsResult
delivery_charge_info
string
Delivery charge in information message on shipment.
checkout_mode
string
Checkout mode of cart.
message
string
Result message of get shipments API.
gstin
string
GSTIN number added in cart.
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process.
last_modified
string
| date-time
Last modified timestamp of cart.
cart_id
integer
| int32
Cart id of the user cart.
is_valid
boolean
Cart validity flag determines the if the response is valid or not.
breakup_values
object (CartBreakup)
CartBreakup
display
array of object (DisplayBreakup)
List of breakup data which is used to display the breakup to the customer like MRP total, Discount, Sub total, coupon value, promotion value and final total.
Array of DisplayBreakup
currency_symbol
string
Currency symbol for the price.
key
string
Key of the price like total_mrp, total, subtotal etc.
display
string
Display key field that to be shown against the value.
message
array of string
List of message at price level to be displayed.
currency_code
string
Currency code for the price .
value
number
| float
Numeric value of the price.
preset
number
| float
Value for the price which is set from platform if applicable.
raw
object (RawBreakup)
RawBreakup
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart.
subtotal
number
| float
Selling price amount of all products in cart.
fynd_cash
number
| float
Loyalty points applied on cart.
discount
number
| float
Discount amount recieved on cart.
convenience_fee
number
| float
Convenience fee amount applied to cart.
delivery_charge
number
| float
Delivery charge applied to cart.
gst_charges
number
| float
GST charges applied on cart.
mrp_total
number
| float
Maximum price total amount of all products in cart.
mop_total
number
| float
Total of payment modes by which payment is going to be done.
total_charge
number
| float
Total amount of charges applied on cart.
coupon
number
| float
Coupon amount applied to cart.
total
number
| float
Total payable amount by the customer.
gift_card
number
| float
Gift cart amount applied on cart.
you_saved
number
| float
Total amount will be saved if customer places the order.
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD.
coupon
object (CouponBreakup)
CouponBreakup
coupon_value
number
| float
Value of the coupon applied to cart.
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon.
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display.
minimum_cart_value
number
| float
Minumum cart value of cart after which the coupon can be applied.
message
string
Coupon message of the coupon applied to cart.
coupon_type
string
Nullable
Type of the coupon applied to cart.
uid
string
Unique identifier of the coupon applied to cart.
value
number
| float
Coupon value of the coupon applied to cart.
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart.
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart.
description
string
Nullable
Coupon description of the coupon applied to cart.
code
string
Coupon code of the coupon applied.
type
string
Type of the coupon applied to cart.
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
total
number
| float
Total loyalty points available with user.
description
string
Description for loyalty points.
applicable
number
| float
Whether the loyalty points are applicable for the cart .
is_applied
boolean
Whether the loyalty points are applied on the cart .
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015.
symbol
string
Currency symbol for currency of user cart prices.
id
string
Cart id of the user cart.
shipments
array of object (ShipmentResult)
List of Shipments which includes shipment data like shipment items, shipment promise, Shipment type, shipment order type, shipment dp options etc.
Array of ShipmentResult
shipments
integer
| int32
Count of shipments that will be shipped.
Default Value : 1
promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
order_type
string
Order type of the shipment like pickAtStore or HomeDelivery.
Enum
box_type
string
Nullable
Box type of the shipment in which the shipment will be delivered.
Default Value : null
shipment_type
string
Shipment type of the shipment returned in get shipments API like single_shipment or multiple shipment. Single Shipment means 1 item in 1 shipment and vice versa in the other one.
dp_options
object
Nullable
Delivery partner options that are available to deliver the shipment.
Default Value : null
dp_id
string
Nullable
Delivery partner id of the shipment.
Default Value : null
items
array of object (CartProductInfo)
Item details in the shipment.
Array of CartProductInfo
article
object (ProductArticle)
ProductArticle
price
object (ArticlePriceInfo)
ArticlePriceInfo
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions.
currency_symbol
string
Currency symbol of the currncy used for price.
marked
number
| float
Original price of product.
currency_code
string
Currency code for all amounts.
product_group_tags
array of string
List fot the unique identifier for the product grouping.
extra_meta
object
Field to update extra meta of the article in cart.
quantity
integer
| int32
Quantity of the article added in cart.
_custom_json
object
Field to update custom json of the article in cart.
meta
object
Article meta data.
size
string
Size of the article added in cart.
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock.
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
seller_identifier
string
List of identifiers used by sellers for the product size.
parent_item_identifiers
object
Fields to determine parent product of the product.
identifier
object
Unique identifier of the article.
store
object (StoreInfo)
StoreInfo
store_code
string
A unique code or identifier for the store, often used for internal reference.
uid
integer
| int32
Unique identifiers of the store from where product is fulfileld.
name
string
Store name of the store from where the product is fulfiled .
cart_item_meta
object
Meta details of the article added from cart.
uid
string
This unique identifier is assigned to the specific article. This represents item x size x location.
gift_card
object
Gift card detail if gift card applied to the product which indicates gift price, gift applicable flag and display message for the gift.
is_gift_visible
boolean
Whether the product can be purchased as a gift. It is true if the product is available for gifting and false otherwise.
type
string
Type of the data sent in response. Possible value is article.
tags
array of string
A list of article tags.
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart.
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user.
price
object (ProductPriceInfo)
ProductPriceInfo
base
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPrice)
ProductPrice
currency_symbol
string
Currency symbol of the price defined for the product.
selling
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
quantity
integer
| int32
Quantity of the product added in cart.
charges
array of object (Charges)
Charges information which denotes types of charges and amount of charge applied to that product in cart.
Array of Charges
meta
object
Meta data realted to charges price adjustment.
amount
object (ChargesAmount)
ChargesAmount
value
number
| float
This is the value of amount added.
currency
string
This is destination currency of value.
name
string
Name of the charge applied.
allow_refund
boolean
Whether refund is allowed or not for the charge.
code
string
Code of the charge applied.
type
string
Type of the charge applied.
discount
string
Discount amount of the product in cart.
availability
object (ProductAvailability)
ProductAvailability
out_of_stock
boolean
Denotes if the product is available in stock.
deliverable
boolean
Deliverable flag denotes if the product is deliverable or not.
available_sizes
array of object (ProductAvailabilitySize)
Product sizes availability.
Array of ProductAvailabilitySize
display
string
Display size of the product.
value
string
Actual value of the size.
is_available
boolean
Available flag for the size of the product if that is available.
is_valid
boolean
Valid flag for the product if the product added in cart is valid to place the order.
other_store_quantity
integer
| int32
Quantity of the product available on other store.
sizes
array of string
All sizes of the product.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
product
object (CartProduct)
CartProduct
_custom_json
object
Field to add custom json of the product in cart.
brand
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller.
name
string
Name of entities like brand or seller.
action
object (ProductAction)
ProductAction
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug.
url
string
Url of the product to render the product
type
string
Type of action.
page
object (ProductActionPage)
ProductActionPage
type
string
Entity of page to be redirected on click
params
object (ProductActionParams)
ProductActionParams
slug
array of string
Unique product url name generated via product name and other meta data.
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a product in cart.
slug
string
Unique product url name generated via product name and other meta data.
images
array of object (ProductImage)
Product Images urls of different types like secure url, aspect ration url and url.
Array of ProductImage
secure_url
string
Secured url of the product image.
aspect_ratio
string
Aspect ratio of the product image.
url
string
Bucket link url for product image.
uid
integer
| int32
Unique identifier of the product in cart.
name
string
Product name of the product in cart which is defined on platform.
item_code
string
Nullable
Product code of the product while defining product on platform.
categories
array of object (CategoryInfo)
Product category information which incldes category name and category id.
Array of CategoryInfo
uid
integer
| int32
Product Category Id.
name
string
Category name of the product .
tags
array of string
Products tags that are added to each product to identify the set of products.
type
string
Type of product in cart.
attributes
object
Product attributes defined on platform.
product_ean_id
string
European Article Number of the product (limited upto 50 EAN identifier in a single request).
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart.
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart.
coupon
object (CouponDetails)
CouponDetails
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product.
code
string
Coupon code of the coupon applied.
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart.
custom_order
object
Whether MTO (Make to Order) is enabled or not.
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied.
key
string
The attribute key associated with the size.
message
string
Product level message which denotes error information to display over the product in cart.
is_set
boolean
Whether or not the product is a set of items.
price_per_unit
object (ProductPricePerUnitInfo)
ProductPricePerUnitInfo
base
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
converted
object (ProductPricePerUnit)
ProductPricePerUnit
currency_symbol
string
Currency symbol of the price defined for the product.
selling_price
number
| float
Selling price of the product .
currency_code
string
Currency code of the price defined for the product.
add_on
number
| float
Price before promotion and coupon amount applied for calculation.
effective
number
| float
Selling price of the product .
marked
number
| float
Maximum price of the product .
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart.
Array of AppliedPromotion
promo_id
string
Promotion id.
buy_rules
array of object (BuyRules)
Buy rules for promotions.
Array of BuyRules
item_criteria
object
Item criteria of promotion.
cart_conditions
object
Cart conditions details for promotion.
offer_text
string
Offer text of current promotion.
promotion_group
string
Promotion group for the promotion.
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP.
promotion_name
string
Promotion name of current promotion.
amount
number
| float
Per unit discount amount applied with current promotion.
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions.
Array of DiscountRulesApp
matched_buy_rules
array of string
Matched buy rules for promotion.
raw_offer
object
Raw offer details for promotion.
offer
object
Offer for promotion.
item_criteria
object
Item criteria of promotion.
ownership
object (Ownership)
Ownership of promotion.
Ownership
payable_category
string
Promotion amount payable category.
payable_by
string
Promotion amount bearable party.
article_quantity
integer
| int32
Quantity of article on which promotion is applicable.
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions.
Array of AppliedFreeArticles
free_gift_item_details
object (FreeGiftItems)
Free gift items details.
FreeGiftItems
item_slug
string
Slug for an item.
item_name
string
Name of the free gift item received via free gift promotion.
item_price_details
object (ItemPriceDetails)
ItemPriceDetails
marked
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
effective
object (PriceMinMax)
PriceMinMax
min
number
| float
Min price of article added in user cart.
max
number
| float
Max price of article added in user cart.
currency
string
Currency of the article added in cart.
article_price
object (ArticlePriceDetails)
ArticlePriceDetails
marked
number
| float
The Marked Price refers to the initial price of the free gift article before product discount.
effective
number
| float
The Effective Price refers to the final amount of the free gift article after applying the product discount.
item_brand_name
string
Item brand name of the free gift item promotion applied on cart.
item_id
integer
| int32
Item id of the free gift item.
available_sizes
array of string
Available sizes for the free gift item.
size
string
Selected size for the free gift item.
item_images_url
array of string
Images URLs for free gift items.
parent_item_identifier
string
Parent item identifier for free article.
quantity
integer
| int32
Quantity of free articles.
article_id
string
IDs of free articles.
promotion_type
string
Promotion type of current promotion.
Enum
meta
object
Meta object for extra data.
code
string
Nullable
Promotion code.
fulfillment_type
string
Fulfilment type of shipment.
fulfillment_id
integer
| int32
Fulfilment id of the shipment.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
enabled
boolean
Denotes if default payment selection is enable.
default_options
string
Default Selection Payment Mode.
payment_identifier
string
Identifier for Payment Mode.
coupon_text
string
Coupon text of coupon applied on cart.
delivery_promise
object (ShipmentPromise)
ShipmentPromise
formatted
object (PromiseFormatted)
PromiseFormatted
max
string
Maximum Delivery promise formatted timestamp.
min
string
Minimum Delivery promise formatted timestamp.
timestamp
object (PromiseTimestamp)
PromiseTimestamp
max
number
| float
Maximum Promise for the shipment.
min
number
| float
Minimum delivery promise time for the shipment.
iso
object (PromiseISOFormat)
PromiseISOFormat
max
string
Max promise in ISO format.
min
string
Min Promise in ISO format.
error
boolean
Error details if any error occurs which includes type of error, error code and error message.
comment
string
Comment message added in cart.
buy_now
boolean
Buy now flag of user cart.
uid
string
Cart id of the user cart.
custom_cart_meta
object
Custom meta details added cart checkout API payload.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response