Cart
Handles shopping carts, including adding, removing, and updating items, as well as calculating totals.
The 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
POST
# Check cart serviceability
GET
# Get abandoned carts
GET
# Get abandoned cart details
POST
# Add items to cart
PUT
# Update cart items
POST
# Share cart link
GET
# List shared cart items
POST
# Update shared cart items
GET
# List of carts
PUT
# Update user of a cart
GET
# Get a cart
POST
# Add items to cart
PUT
# Update cart items
PUT
# Delete a cart
GET
# Get a cart items count
PUT
# Update cart metadata
Verify the serviceability of items in the cart at a specific pin code and ensure accurate delivery promises. System checks each item's availability and delivery feasibility, providing real-time information on serviceability and estimated delivery times.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Request body
cart_items
array of object (CartItem)
Required
List of items in open api cart response
Array of CartItem
quantity
integer
| int32
Quantity of product in cart
product_id
string
Required
Unique identifier of product in cart
size
string
Required
Size of product in cart
shipping_address
object (ShippingAddress)
Required
ShippingAddress
country
string
Nullable
Country of address
state
string
Nullable
State of the address
city
string
Nullable
City of the address
phone
integer
| int32
Phone number for address
area_code
string
Required
Area code of the address
Minimum Length : 1
country_iso_code
string
Country iso code for address
country_phone_code
string
Country phone code for address
meta
object
Metadata of the address
address_type
string
Address type of address
area
string
Area description for address
area_code_slug
string
Area code slug for address. example pincode is slug for India
Default Value : pincode
name
string
Name of person in address data to whom it belongs to
landmark
string
Landmark of address
email
string
Email address for address data
country_code
string
Country code of address
Default Value : IND
pincode
integer
| int32
Pincode for address data
address
string
Address description for address data
Response
200
Cart details with pincode validity information at item level
OpenApiCartServiceabilityResult
is_valid
boolean
Cart validity flag determines the if the response is valid or not
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
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.
message
string
Message of the cart detail API response
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Check cart serviceability
checkCartServiceability
Retrieve the list of abandoned carts that have been active for the specified period of time and have not yet been archived for the specific sales channel.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
page_no
integer
current page no as per pagination
Default Value : 0
page_size
integer
Cart max records fetched in single request
Default Value : 10
from_date
string
| date-time
Cart which are created on or after from_date
to_date
string
| date-time
Cart which are created on or before to_date
anonymous_cart
boolean
Filter by `anonymous_cart`
last_id
string
pagination is done based on the last_object_id
sort_on
string
on which column to sort on i.e created_on or last_modified
Response
200
Abandoned Cart List for sent page_size and page_no
AbandonedCartResult
items
array of object (AbandonedCart)
List of items in abandon cart
Array of AbandonedCart
expire_at
string
| date-time
Expire details of user cart
promotion
object
Promotion object details like amount, mode, currency and list of promotions in user cart
is_default
boolean
User cart default status
comment
string
Nullable
Comment message to be added in user cart
articles
array of object
List of articles in user cart
coupon
object
Nullable
Coupon data of user cart which denotes if coupon is applied, coupon code, coupon amount, coupon title and coupon message
bulk_coupon_discount
number
| float
Nullable
Total bulk discount amount applied in user cart
_id
string
Unique identifier of the user cart
fynd_credits
object
Fynd credit points applied in user cart
fc_index_map
array of integer
Flat article index in user cart
order_id
string
Order id generated in user cart
discount
number
| float
Discount amount of the product in cart
cod_charges
object
Cash On Delivery charges of the user cart
payments
object
Nullable
Payment object selected in user cart
payment_mode
string
Nullable
Payment mode of the payment selected to do the payment
shipments
array of object
Shipment details for the items in a cart, specific to the selected address.
pick_up_customer_details
object
Nullable
Customer contact details for customer pickup at store
uid
integer
| int32
Unique Identifier of user cart
checkout_mode
string
Checkout mode of user cart
cart_value
number
| float
Total amount of user cart
is_archive
boolean
Flag to indicate cart is archived or not
created_on
string
| date-time
Date time format when user cart created
last_modified
string
| date-time
Date time format when user cart last modified
meta
object
Nullable
Extra meta data of user cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
is_active
boolean
Flag indicates user cart is active or not
cashback
object
Cart level cashback data which denotes cashback amount and cashback message
payment_methods
array of object
Payment methods list used to make the payment
gstin
string
Nullable
GSTIN added in user cart
delivery_charges
object
Delivery charges of user cart
merge_qty
boolean
Nullable
Flag indicates cart has merged article or not
user_id
string
User Id of user cart
app_id
string
Application id of user cart
result
object
Define the list of items with updated status
page
object (Page)
Page
item_total
integer
| int32
The total number of items on the page.
next_id
string
The identifier for the next page.
has_previous
boolean
Indicates whether there is a previous page.
has_next
boolean
Indicates whether there is a next page.
current
integer
| int32
The current page number.
type
string
The type of the page, such as 'PageType'.
size
integer
| int32
The number of items per page.
page_size
integer
| int32
The number of items per page.
success
boolean
The request success is defined
message
string
message of the response
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Get abandoned carts
getAbandonedCart
Retrieves abandoned cart details 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
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
The unique identifier of the cart
i
boolean
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
c
boolean
This is a boolean value. Select `true` to retrieve the cod charges in breakup of cart items.
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
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
i:
false
b:
false
c:
false
Was this section helpful?
GET
Response
Get abandoned cart details
getAbandonedCartDetails
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
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
cart_id
string
Required
Current Cart id of user cart
b
boolean
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
Request body
new_cart
boolean
Field to create to new cart whille user adds item to cart
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
quantity
integer
| int32
Field to specify the product quantity that user wants to buy
item_size
string
Field to determine size of the product
seller_id
integer
| int32
Unique identifier of the seller selected by the user from which user want to buy a product
parent_item_identifiers
array of object
Fields to determine parent product of the product
product_group_tags
array of string
Field to specify the product groups of the product that the user is trying to add in cart
article_id
string
Unique identifier of an article
article_assignment
object
Field to determine how article assignment should happen by article assignment level and strategy
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
item_id
integer
| int32
Unique identifier to identify product
extra_meta
object
Extra meta data to be added at article level while add items to cart
_custom_json
object
Field to add custom json at article level while add items to cart
meta
object
Field to add meta data at article level
pos
boolean
Filed to determine whether user is making request from pos or not
seller_identifier
string
Add items using seller identifier for store os
Response
200
Success. Returns a cart object as shown below. Refer `AddCartDetailResult` for more details.
AddCartDetailResult
success
boolean
True if all items are added successfully. False if partially added or not added.
cart
object (CartDetailResult)
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart
uid
string
Unique identifier of the user cart
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
partial
boolean
When adding multiple items check if all added. True if only few are added.
message
string
Message of add cart API response
result
object
Add to cart result data
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
Add items to cart
addItems
Customers can modify added product attributes such as quantity and size, as well as remove items from the cart.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
cart_id
string
Required
Current Cart id of user cart
b
boolean
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
Request body
items
array of object (UpdateProductCart)
Array of UpdateProductCart
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
parent_item_identifiers
object
Field to update parent product of the item in cart
meta
object
Field to update meta of the item in cart
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
item_id
integer
| int32
Item id of the product that needs to be updated
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
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
Cart opertaion type
Enum
Response
200
Success. Updates and returns a cart object as shown below. Refer `UpdateCartDetailResult` for more details.
UpdateCartDetailResult
success
boolean
True if all items are added successfully. False if partially added or not added.
cart
object (CartDetailResult)
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart
uid
string
Unique identifier of the user cart
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
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.
message
string
Message of update cart API response
Examples
Parameters
Parameters are not required.
Was this section helpful?
PUT
Response
Update cart items
updateCart
Share cart link
getCartShareLink
List shared cart items
getCartSharedItems
Update shared cart items
updateCartWithSharedItems
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
from_date
string
| date-time
Cart which are created on or after from_date. Supports ISO date format.
to_date
string
| date-time
Cart which are created on or before to_date. Supports ISO date format.
filter_on
string
on which column to sort on i.e created_on or last_modified
Response
200
Platform user cart list
MultiCartResult
success
boolean
True if get list of cart successfully.
data
array of object (CartList)
List of active carts and their item's count
Array of CartList
cart_id
string
The cart id of user
pick_up_customer_details
object
Customer contact details for customer pickup at store
cart_value
number
| float
Total amount of cart
created_on
string
| date-time
Date format when cart created
user_id
string
User id which is associated with cart
currency_code
string
Active cart currency code
item_counts
integer
Article total count in cart
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
List of carts
getCartList
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
Cart id of user cart
Request body
user_id
string
Required
User Id of user for which we map with the cart
Response
200
UserCartMappingResult
coupon_text
string
Coupon text of coupon applied on cart
user
object (UserInfo)
UserInfo
gender
string
User gender
modified_on
string
| date-time
Date format of user when user last modified
_id
string
Unique Identifier of user
uid
string
Unique UID of user
external_id
string
Unique external id
mobile
string
10 digit Mobile number of user
last_name
string
| date-time
Last name of user
created_at
string
| date-time
Date format of user when user registered
first_name
string
First name of user
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
delivery_charge_info
string
Delivery charge in information message on shipment
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the get cart detail API response
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in user cart
custom_cart_meta
object
Custom meta details added cart checkout API payload
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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
Examples
Parameters
Parameters are not required.
Was this section helpful?
PUT
Response
Update user of a cart
updateCartUser
Retrieve details of a cart linked to a specific customer using either the customer's ID or a unique cart ID. It offers an overview of the items, quantities, prices, and other relevant information associated with the cart.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
The unique identifier of the cart
user_id
string
Option to fetch cart for the provided user_id.
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.
i
boolean
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
assign_card_id
integer
Token of user's debit or credit card
buy_now
boolean
This is a boolen value. Select `true` to set/initialize buy now cart
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Response
200
400
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
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
user_id:
"value"
order_type:
"value"
i:
false
b:
false
assign_card_id:
1
buy_now:
false
x-ordering-source:
"default"
Was this section helpful?
GET
Response
Get a cart
getCart
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
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
i
boolean
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
buy_now
boolean
This is a boolen value. 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.
id
string
The unique identifier of the cart
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Request body
user_id
string
The user id of user, for which we need to add item into cart
new_cart
boolean
Field to create to new cart whille user adds item to cart
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
quantity
integer
| int32
Field to specify the product quantity that user wants to buy
item_size
string
Field to determine size of the product
seller_id
integer
| int32
Unique identifier of the seller selected by the user from which user want to buy a product
parent_item_identifiers
array of object
Fields to determine parent product of the product
product_group_tags
array of string
Field to specify the product groups of the product that the user is trying to add in cart
article_id
string
Unique identifier of an article
article_assignment
object
Field to determine how article assignment should happen by article assignment level and strategy
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
item_id
integer
| int32
Unique identifier to identify product
extra_meta
object
Extra meta data to be added at article level while add items to cart
_custom_json
object
Field to add custom json at article level while add items to cart
meta
object
Field to add meta data at article level
pos
boolean
Filed to determine whether user is making request from pos or not
seller_identifier
string
Add items using seller identifier for store os
Response
200
Success. Returns a cart object as shown below. Refer `AddCartDetailResult` for more details.
AddCartDetailResult
success
boolean
True if all items are added successfully. False if partially added or not added.
cart
object (CartDetailResult)
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart
uid
string
Unique identifier of the user cart
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
partial
boolean
When adding multiple items check if all added. True if only few are added.
message
string
Message of add cart API response
result
object
Add to cart result data
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
Add items to cart
platformAddItems
Customers can modify added product attributes such as quantity and size, as well as remove items from the cart.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
The unique identifier of the cart
i
boolean
This is a boolean value. Select `true` to retrieve all the items added in 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.
b
boolean
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
buy_now
boolean
This is a boolen value. Select `true` to set/initialize buy now cart
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Request body
user_id
string
The user id of user, for which we need to update the cart
items
array of object (UpdateProductCart)
List items data that needs to be updated in cart
Array of UpdateProductCart
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
parent_item_identifiers
object
Field to update parent product of the item in cart
meta
object
Field to update meta of the item in cart
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
item_id
integer
| int32
Item id of the product that needs to be updated
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
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
success
boolean
True if all items are added successfully. False if partially added or not added.
cart
object (CartDetailResult)
CartDetailResult
cart_id
integer
| int32
Unique identifier of the user cart
uid
string
Unique identifier of the user cart
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
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.
message
string
Message of update cart API response
Examples
Parameters
Parameters are not required.
Was this section helpful?
PUT
Response
Update cart items
platformUpdateCart
Delete all items from the user's cart and resets it to its initial state, providing a clean slate for new selections.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
The unique identifier of the cart.
Request body
cart_id_list
array of string
List of all cart ids, which need to delete
Response
200
Success. Returns whether the cart has been deleted or not.
DeleteCartDetailResult
success
boolean
True if cart is archived successfully. False if not archived.
message
string
Message for delete cart response
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
body:
body
Was this section helpful?
PUT
Response
Delete a cart
deleteCart
Retrieve the total count of items currently present in the customer's cart.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
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
company_id:
"value"
application_id:
"value"
id:
"value"
buy_now:
false
Was this section helpful?
GET
Response
Get a cart items count
getItemCount
Add or modify metadata associated with a cart, which includes customer preferences, delivery instructions, or any special requirements related to the cart items.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
The unique identifier of the cart
buy_now
boolean
this is boolean to get buy_now cart
Request body
gstin
string
GSTIN number to be added in user cart
pick_up_customer_details
object
Customer contact details for customer pickup at store
checkout_mode
string
Checkout mode of user cart
gift_details
object
Nullable
Gift details is open json which can include gift message
pan_no
string
Permanent Account Number of the user
comment
string
Comment message to be added in user cart
staff_user_id
string
Nullable
staff user id
Response
200
400
Returns a message indicating the success of cart meta updation as shown below.
CartMetaDetails
is_valid
boolean
Whether added meta was vaild
message
string
Detailed message that used to display
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
buy_now:
false
body:
body
Was this section helpful?
PUT
Response
Update cart metadata
updateCartMeta
Cart meta includes configuration settings for customizing and optimizing the cart experience, such as adjusting item limits, configuring discounts, and managing delivery charges, to meet the needs of sales channels effectively.
Operations
PUT
# Update cart meta
GET
# Get cart meta
POST
# Create a new cart meta
Modify the configuration settings for cart metadata associated with a specific sales channel. Cart meta includes configuration settings such as allowed maximum cart value, allowed minimum cart value, maximum allowed cart items, delivery charges, etc.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
cart_meta_id
string
Required
CartMeta id for fetching single cart meta data for editing
Request body
min_cart_value
integer
| int32
Minimum order value to checkout
max_cart_value
integer
| int32
Maximum order value to checkout
bulk_coupons
boolean
Indicates bulk coupon applicable for cart
max_cart_items
integer
| int32
Maximum cart items to checkout
gift_display_text
string
Free gift charges text to show
delivery_charges
object (DeliveryCharges)
DeliveryCharges
charges
array of object (Charges)
List of delivery changes information of the cart
Array of Charges
charges
integer
| int32
Delivery chanrges applied on the product of cart
threshold
integer
| int32
Threshold of cart value on which the charge should be applied
enabled
boolean
Enable or disable delivery charge on cart
revenue_engine_coupon
boolean
It define credit coupon applicable for cart
gift_pricing
number
| float
Free gift charges per product
enabled
boolean
Enabled flag for cart configuration
Response
200
400
Cart Meta Config updated successfully
CartMetaConfigUpdate
min_cart_value
integer
| int32
Minimum order value to checkout
max_cart_value
integer
| int32
Maximum order value to checkout
bulk_coupons
boolean
Indicates bulk coupon applicable for cart
max_cart_items
integer
| int32
Maximum cart items to checkout
gift_display_text
string
Free gift charges text to show
delivery_charges
object (DeliveryCharges)
DeliveryCharges
charges
array of object (Charges)
List of delivery changes information of the cart
Array of Charges
charges
integer
| int32
Delivery chanrges applied on the product of cart
threshold
integer
| int32
Threshold of cart value on which the charge should be applied
enabled
boolean
Enable or disable delivery charge on cart
revenue_engine_coupon
boolean
It define credit coupon applicable for cart
gift_pricing
number
| float
Free gift charges per product
enabled
boolean
Enabled flag for cart configuration
Examples
Parameters
company_id:
"value"
application_id:
"value"
cart_meta_id:
"value"
body:
body
Was this section helpful?
PUT
Response
Update cart meta
updateCartMetaConfig
Retrieve meta configuration settings tailored for customizing the cart experience within a specific sales channel. Cart meta includes configuration settings such as allowed maximum cart value, allowed minimum cart value, maximum allowed cart items, delivery charges, etc.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Response
200
400
Cart Meta Config Fetched successfully
CartMetaConfigAdd
min_cart_value
integer
| int32
Minimum order value to checkout
max_cart_value
integer
| int32
Maximum order value to checkout
bulk_coupons
boolean
Indicates bulk coupon applicable for cart
max_cart_items
integer
| int32
Maximum cart items to checkout
gift_display_text
string
Free gift charges text to show
delivery_charges
object (DeliveryCharges)
DeliveryCharges
charges
array of object (Charges)
List of delivery changes information of the cart
Array of Charges
charges
integer
| int32
Delivery chanrges applied on the product of cart
threshold
integer
| int32
Threshold of cart value on which the charge should be applied
enabled
boolean
Enable or disable delivery charge on cart
revenue_engine_coupon
boolean
It define credit coupon applicable for cart
gift_pricing
number
| float
Free gift charges per product
enabled
boolean
Enabled flag for cart configuration
Examples
Parameters
company_id:
"value"
application_id:
"value"
Was this section helpful?
GET
Response
Get cart meta
fetchCartMetaConfig
Create custom meta configurations for carts associated with a specific sales channel. By specifying the company ID and application ID, seller can define unique cart settings, including preferences, rules, and constraints, tailored to their business needs.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Request body
min_cart_value
integer
| int32
Minimum order value to checkout
max_cart_value
integer
| int32
Maximum order value to checkout
bulk_coupons
boolean
Indicates bulk coupon applicable for cart
max_cart_items
integer
| int32
Maximum cart items to checkout
gift_display_text
string
Free gift charges text to show
delivery_charges
object (DeliveryCharges)
DeliveryCharges
charges
array of object (Charges)
List of delivery changes information of the cart
Array of Charges
charges
integer
| int32
Delivery chanrges applied on the product of cart
threshold
integer
| int32
Threshold of cart value on which the charge should be applied
enabled
boolean
Enable or disable delivery charge on cart
revenue_engine_coupon
boolean
It define credit coupon applicable for cart
gift_pricing
number
| float
Free gift charges per product
enabled
boolean
Enabled flag for cart configuration
Response
201
400
Cart Meta Config Created successfully
CartMetaConfigAdd
min_cart_value
integer
| int32
Minimum order value to checkout
max_cart_value
integer
| int32
Maximum order value to checkout
bulk_coupons
boolean
Indicates bulk coupon applicable for cart
max_cart_items
integer
| int32
Maximum cart items to checkout
gift_display_text
string
Free gift charges text to show
delivery_charges
object (DeliveryCharges)
DeliveryCharges
charges
array of object (Charges)
List of delivery changes information of the cart
Array of Charges
charges
integer
| int32
Delivery chanrges applied on the product of cart
threshold
integer
| int32
Threshold of cart value on which the charge should be applied
enabled
boolean
Enable or disable delivery charge on cart
revenue_engine_coupon
boolean
It define credit coupon applicable for cart
gift_pricing
number
| float
Free gift charges per product
enabled
boolean
Enabled flag for cart configuration
Examples
Parameters
company_id:
"value"
application_id:
"value"
body:
body
Was this section helpful?
POST
Response
Create a new cart meta
createCartMetaConfig
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
# Get and validate cart items
POST
# Checkout cart
POST
# Update cart checkout
POST
# Checkout cart
Retrieve cart details for a provided list of cart items and validate its contents. This ensures accuracy and completeness in cart information, including item quantities, prices, discounts, and applicable taxes.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Request body
cart_items
array of object (CartItem)
Required
List of products in cart
Array of CartItem
quantity
integer
| int32
Quantity of product in cart
product_id
string
Required
Unique identifier of product in cart
size
string
Required
Size of product in cart
Response
200
400
Cart details with breakup
OpenapiCartDetailsResult
is_valid
boolean
Cart validity flag determines the if the response is valid or not
message
string
Message of the cart Open API cart detail response
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
items
array of object (CartProductInfo)
Items details in cart
Array of CartProductInfo
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
Examples
Parameters
company_id:
"value"
application_id:
"value"
body:
body
x-ordering-source:
"default"
Was this section helpful?
POST
Response
Get and validate cart items
fetchAndvalidateCartItems
The checkout cart initiates the order creation process based on the selected address and payment method. It revalidates the cart details to ensure safe and seamless order placement.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Request body
payment_mode
string
Payment mode from which the payment to be done for the order
cart_value
number
| float
Required
Total amount of user cart
cart_items
array of object (OpenApiOrderItem)
Required
List of items in user cart
Array of OpenApiOrderItem
cashback_applied
number
| float
Required
Cashback applied on user cart
quantity
integer
| int32
Article quantity in user cart
Default Value : 1
size
string
Required
Size of the article added in cart
coupon_effective_discount
number
| float
Required
Coupon discount applied on article in user cart
amount_paid
number
| float
Required
Amount needs to paid for article in cart
delivery_charges
number
| float
Required
Delivery charges applied on article in cart
price_marked
number
| value >= 0
| float
Required
Original price of product
files
array of object (OpenApiFiles)
List of file url
Array of OpenApiFiles
key
string
Required
Key represents name of file
values
array of string
Required
List of urls path
meta
object (CartItemMeta)
CartItemMeta
primary_item
boolean
Flags indicates item is primary or not
group_id
string
Fields to determine group id of the product
extra_meta
object
Extra meta of the article in cart
product_id
integer
| int32
Required
Product id associated with article in cart
loyalty_discount
number
| float
Loyalty points applied on cart
Default Value : 0
discount
number
| float
Required
Discount value applied on article in cart
price_effective
number
| value >= 0
| float
Required
Current per unit price of product after existing deductions
payment_methods
array of object (MultiTenderPaymentMethod)
Required
Payment methods list used to make the payment
Array of MultiTenderPaymentMethod
mode
string
Required
Payment mode of payment method used to make payment
amount
number
| float
Required
Amount of the payment mode to be paid
meta
object (MultiTenderPaymentMeta)
MultiTenderPaymentMeta
payment_id
string
Nullable
Payment gateway identifier
payment_gateway
string
Nullable
Payment gateway used to do the payment
extra_meta
object
Nullable
Payment extra meta for the payment mode to do the payment
current_status
string
Nullable
Current status of the payment
order_id
string
Nullable
Payment gateway order id
name
string
Name of the payment mode used to make payment
employee_discount
number
| float
Employee discount value applied on article in cart
Default Value : 0
cod_charges
number
| float
Required
Cash On Delivery charges applied on article in cart
shipping_address
object (ShippingAddress)
ShippingAddress
country
string
Nullable
Country of address
state
string
Nullable
State of the address
city
string
Nullable
City of the address
phone
integer
| int32
Phone number for address
area_code
string
Required
Area code of the address
Minimum Length : 1
country_iso_code
string
Country iso code for address
country_phone_code
string
Country phone code for address
meta
object
Metadata of the address
address_type
string
Address type of address
area
string
Area description for address
area_code_slug
string
Area code slug for address. example pincode is slug for India
Default Value : pincode
name
string
Name of person in address data to whom it belongs to
landmark
string
Landmark of address
email
string
Email address for address data
country_code
string
Country code of address
Default Value : IND
pincode
integer
| int32
Pincode for address data
address
string
Address description for address data
loyalty_discount
number
| float
Loyalty points applied on cart
comment
string
Nullable
Comment message added in cart after order placed
payment_methods
array of object (MultiTenderPaymentMethod)
Required
payment methods list used to make the payment
Array of MultiTenderPaymentMethod
mode
string
Required
Payment mode of payment method used to make payment
amount
number
| float
Required
Amount of the payment mode to be paid
meta
object (MultiTenderPaymentMeta)
MultiTenderPaymentMeta
payment_id
string
Nullable
Payment gateway identifier
payment_gateway
string
Nullable
Payment gateway used to do the payment
extra_meta
object
Nullable
Payment extra meta for the payment mode to do the payment
current_status
string
Nullable
Current status of the payment
order_id
string
Nullable
Payment gateway order id
name
string
Name of the payment mode used to make payment
employee_discount
object
Employee discount value applied on user cart
coupon
string
Coupon text of coupon applied on user cart
cashback_applied
number
| float
Required
Cashback applied on user cart
gstin
string
Nullable
GSTIN number added in cart
billing_address
object (ShippingAddress)
Required
ShippingAddress
country
string
Nullable
Country of address
state
string
Nullable
State of the address
city
string
Nullable
City of the address
phone
integer
| int32
Phone number for address
area_code
string
Required
Area code of the address
Minimum Length : 1
country_iso_code
string
Country iso code for address
country_phone_code
string
Country phone code for address
meta
object
Metadata of the address
address_type
string
Address type of address
area
string
Area description for address
area_code_slug
string
Area code slug for address. example pincode is slug for India
Default Value : pincode
name
string
Name of person in address data to whom it belongs to
landmark
string
Landmark of address
email
string
Email address for address data
country_code
string
Country code of address
Default Value : IND
pincode
integer
| int32
Pincode for address data
address
string
Address description for address data
coupon_code
string
Required
Coupon code to be applied to cart
coupon_value
number
| float
Required
Value of the coupon applied to cart
delivery_charges
number
| float
Required
Delivery charges of the order placed via checkout API
affiliate_order_id
string
Order id generated after placing order
currency_code
string
Currency code for the price
order_id
string
Order id generated after placing order
files
array of object (OpenApiFiles)
List of file url
Array of OpenApiFiles
key
string
Required
Key represents name of file
values
array of string
Required
List of urls path
cod_charges
number
| float
Required
Cash On Delivery charges of the user cart
Response
200
400
Checkout cart and create Fynd order id
OpenApiCheckoutResult
success
boolean
The request success is defined
message
string
Message of the api response
order_ref_id
string
Order id sent in request
order_id
string
Fynd order id
Examples
Parameters
company_id:
"value"
application_id:
"value"
body:
body
x-ordering-source:
"default"
Was this section helpful?
POST
Response
Checkout cart
checkoutCart
Overrides the cart's checkout process with a new provided cart items. It provides flexibility in customizing checkout flows to meet specific business requirements, enhancing the user experience and optimizing order processing workflows.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Request body
cart_id
string
Required
The cart id of user cart
payment_mode
string
Required
Payment mode from which the payment to be done for the order
billing_address
object
Billing address json which includes customer address, customer phone, customer email, customer pincode, customer landmark and customer name
merchant_code
string
Required
Merchant code of the payment mode selected to do the payment
payment_identifier
string
Required
Payment identifier of the payment mode selected to do the payment
currency_code
string
Required
Currency code for the price
aggregator
string
Required
Aggregator name of the payment gateway
order_type
string
Required
Order type of the order being placed like pickAtStore or HomeDelivery
Enum
callback_url
string
Callback url to be redirected after payment received/failed
cart_items
array of object (OverrideCartItem)
Required
List of items which includes their size, id, discount and promo details
Array of OverrideCartItem
seller_identifier
string
Seller identifiers of the product size.
quantity
integer
| int32
Item quantity, which you have added into cart
Default Value : 1
size
string
Required
Item size, which you have added into cart
price_marked
number
| value >= 0.01
| float
Required
Original price of product
amount_paid
number
| value >= 0.01
| float
Required
Amount needs to paid for item
promo_list
array of object (OverrideCartItemPromo)
List of promotion applied on item
Array of OverrideCartItemPromo
promo_id
string
Required
Promotion id applied on product
promo_amount
string
Required
Promotion amount applied on product
promo_desc
string
Promotion description applied on product
rwrd_tndr
string
item_list
array of object
List of items
parent_promo_id
string
Parent promotion unique identifier
extra_meta
object
Extra meta to be added while checkout in order
item_id
integer
| int32
Required
Item unique id in user cart
discount
number
| float
Required
Discount amount applied on item
price_effective
number
| value >= 0.01
| float
Required
Current per unit price of product after existing deductions
ordering_store
integer
| int32
Nullable
Ordering store id of the store from which the order is getting placed
Default Value : null
shipping_address
object
Shipping address json which includes name, area, address, phone, area_code, state, country, country code and email
Response
200
Checkout cart and create Fynd order id
OverrideCheckoutResult
data
object
Data of the user cart checkout includes cart data, address, user id, order type etc
cart
object
Cart details in API response which included cart id, items in cart, promise, order type, breakup values etc.
success
string
Success flag of cart override checkout API response
order_id
string
Order id generated after placing order
message
string
Message of the cart override checkout API response
Examples
Parameters
company_id:
"value"
application_id:
"value"
body:
body
x-ordering-source:
"default"
Was this section helpful?
POST
Response
Update cart checkout
overrideCart
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
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
The unique identifier of the cart
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Request body
address_id
string
Address id of the user on which the order to be delivered
payment_identifier
string
Nullable
Payment identifier of the payment mode selected to do the payment
payment_params
object
Nullable
Payment params which includes payment identifier and merchant code
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
payment_auto_confirm
boolean
Payment auto confirm flag if payment need not to be collected from user
id
string
Required
Cart id of the user cart
pos
boolean
Filed to determine whether user is making request from pos or not
billing_address_id
string
Billing address id of the customer on which the invoice to be generated after the order is placed
merchant_code
string
Merchant code of the payment mode selected to do the payment
aggregator
string
Aggregator name of the payment gateway
pick_at_store_uid
integer
| int32
Nullable
Store id where we have to pick product
Default Value : null
device_id
string
Nullable
Device id
delivery_address
object
Delivery address data which includes customer address, customer phone, customer email, customer pincode, customer landmark and customer name
payment_mode
string
Payment mode from which the payment to be done for the order
checkout_mode
string
Mode of checkout used in cart
customer_details
object (CustomerDetails)
CustomerDetails
name
string
Name of customer to be added in customer detail while checkout
email
string
Nullable
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
meta
object
Meta data to be added in order
payment_methods
array of object (PaymentMethod)
Required
Payment methods list used to make the payment
Array of PaymentMethod
mode
string
Required
Payment mode of payment method used to make payment
payment
string
Payment name of payment method used to make payment
payment_meta
object (PaymentMeta)
Required
PaymentMeta
payment_gateway
string
Payment gateway used to do the payment
type
string
Type of card if payment mode is card to do the payment
payment_identifier
string
Nullable
Payment identifier of the payment mode selected to do the payment
merchant_code
string
Merchant code of the payment mode selected to do the 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
staff
object (StaffCheckout)
StaffCheckout
employee_code
string
Employee code of staff who does checkout on behalf of customer
_id
string
Required
Id 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
employee_code
string
Nullable
Employee code of staff who does checkout on behalf of customer
billing_address
object
Billing address json which includes customer address, customer phone, customer email, customer pincode, customer landmark and customer name
callback_url
string
Nullable
callback url after payment received/failed
Default Value : null
user_id
string
The user id of user cart
extra_meta
object
Extra meta to be added while checkout in order
order_type
string
Required
Order type of the order being placed like pickAtStore or HomeDelivery
Enum
files
array of object (Files)
List of file url
Array of Files
key
string
Required
Key represents name of file
values
array of string
Required
List of urls path
ordering_store
integer
| int32
Nullable
Ordering store id of the store from which the order is getting placed
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 `CartCheckoutDetailsSchema` for more details.
CartCheckoutDetails
app_intercept_url
string
App intercept url which is used to redirect on app after payment in confirmed/failed
data
object
Data of the user cart checkout includes cart data, address, user id, order type etc
cart
object (CheckCart)
CheckCart
coupon_text
string
Coupon text of the applied coupon on order placed
cod_message
string
Cash On Delivery message for the order placed
id
string
Cart id of the user cart
store_code
string
Store code from which the order placed
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
user_type
string
User type of the cart who places the order
items
array of object (CartProductInfo)
Items details in cart after order placed
Array of CartProductInfo
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
error_message
string
Error details if any error occurs which includes type of error, error code and error message
success
boolean
Success flag of checkout cart API response
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
delivery_charge_info
string
Delivery charge in information message on shipment
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
order_id
string
Order id generated after placing order
message
string
Message of the cart checkout API response
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
cod_charges
number
| float
Cash On Delivery charges of the user cart
is_valid
boolean
Valid flag fotr the checkout response if order placed was valid
uid
string
Cart id of user cart
checkout_mode
string
Checkout mode of user cart
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag of user cart
delivery_charge_order_value
integer
| int32
Delivery charge order value
cart_id
integer
| int32
Cart id of the user cart for which the order placed
store_emps
array of object
Store employees data
gstin
string
GSTIN number added in cart
cod_available
boolean
Whether Cash On Delivery available
delivery_charges
number
| float
Delivery charges of the order placed via checkout API
custom_cart_meta
object
Custom meta details added cart checkout API payload
success
boolean
Success flag of cart checkout API response
callback_url
string
Callback url to be redirected after payment received/failed
payment_confirm_url
string
Payment confirm url used to redirect after payment is confirmed
order_id
string
Order id generated after placing order
message
string
Message of the cart checkout v2 API response
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
Response
Checkout cart
platformCheckoutCartV2
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 of coupons
POST
# Create a coupon
GET
# Get a coupon
PUT
# Update a coupon
DEL
# Delete a coupon which is in draft state
GET
# Check coupon code exists
GET
# List of coupons
POST
# Apply coupon
DEL
# Remove coupon
GET
# Validate applied coupon
Retrieve a list of all created coupons for specific sales channel. It also supports searching based on text search, pagination and other flags to filter coupons.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
page_no
integer
current page no as per pagination
Default Value : 0
page_size
integer
Coupon max records fetched in single request
Default Value : 10
is_archived
boolean
Filter by active or inactive coupon
Default Value : false
title
string
Filter coupon by coupon title
is_public
boolean
Filter coupons which is public
is_display
boolean
Filter coupons which is visible to sales channel
type_slug
string
Filter by coupon type
code
string
Filter by coupon code
created_by
string
Filter by coupon creater user id
reviewed_by
string
Filter by coupon reviewer user id
approved_start_time
string
| date-time
Filter coupon by start time date range when status is approved
approved_end_time
string
| date-time
Filter coupon by end time date range when status is approved
review_start_time
string
Filter coupon by start time date range when status is in review state
review_end_time
string
Filter coupon by end time date range when status is in review state
status
string
Filter your coupons effortlessly by status, such as draft, review and more
Enum
Response
200
Coupon List for sent page_size and page_no
CouponsResult
items
array of object (CouponAdd)
Coupons list for sales channel
Array of CouponAdd
date_meta
object (CouponDateMeta)
CouponDateMeta
modified_on
string
| date-time
Nullable
Date time format when the coupon last modified
Default Value : null
created_on
string
| date-time
Nullable
Date time format when the coupon created
Default Value : null
approved_on
string
| date-time
Nullable
Date time format when the coupon approved
Default Value : null
rejected_on
string
| date-time
Nullable
Date time format when the coupon rejected
Default Value : null
reviewed_on
string
| date-time
Nullable
Date time format when the coupon reviewed
Default Value : null
ownership
object (Ownership)
Ownership
payable_category
string
Coupon amount payable category
Enum
payable_by
string
Nullable
Coupon amount bearable party
author
object (CouponAuthor)
CouponAuthor
created_by
string
Nullable
The user id of user, who has created the coupon
Default Value : null
modified_by
string
Nullable
The user id of user, who has modified the coupon
Default Value : null
approved_by
string
Nullable
The user id of user, who has approved the coupon
Default Value : null
rejected_by
string
Nullable
The user id of user, who has rejected the coupon
Default Value : null
reviewed_by
string
Nullable
The user id of user, who has reviewed the coupon
Default Value : null
state
object (State)
State
is_archived
boolean
Publish or unpublish the coupon
Default Value : false
is_display
boolean
Coupon needs to display or not
Default Value : true
is_public
boolean
Coupon is publicaly available or not
Default Value : true
restrictions
object (Restrictions)
Restrictions
payments
object (PaymentModes)
PaymentModes
codes
array of string
Identifier used by payment gateway for a given payment mode, e.g. NB_ICIC, PAYTM
iins
array of string
Debit/Credit card prefix (first 6 digit)
types
array of string
Card type, e.g. Credit, Debit
networks
array of string
Credit/Debit card issuer, e.g. VISA, MASTERCARD, RUPAY
uses
object (PaymentAllowValue)
PaymentAllowValue
max
integer
| int32
Maximum value need to allow for payment
user_type
string
price_range
object (PriceRange)
PriceRange
max
integer
| int32
Max price valid for article in coupon
Default Value : -1
min
integer
| int32
Min price valid for article in coupon
Default Value : -1
platforms
array of string
List of platform on which coupon allowed like web, android
post_order
object (PostOrder)
PostOrder
cancellation_allowed
boolean
Cancellation allowed in coupon
Default Value : true
return_allowed
boolean
Return allowed in coupon
Default Value : true
bulk_bundle
object (BulkBundleRestriction)
BulkBundleRestriction
multi_store_allowed
boolean
Multi store allowed in bulk bundle coupon or not
user_groups
array of integer
List of user group on which coupon allowed
coupon_allowed
boolean
Allow applying normal coupon if bulk coupon is applied
uses
object (UsesRestriction)
UsesRestriction
maximum
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
remaining
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
ordering_stores
array of integer
List of store id on which coupon allowed
validation
object (Validation)
Validation
app_id
array of string
List of sales channel's application id
Default Value :
anonymous
boolean
Coupon applicable for guest user or not
user_registered_after
string
| date-time
Nullable
Coupon applicable for user which is registered after Date Format
Default Value : null
action
object (CouponAction)
CouponAction
action_date
string
| date-time
Nullable
Coupon transaction mode's date time format
Default Value : null
txn_mode
string
Coupon transaction mode like cash, coupon etc
Default Value : coupon
Enum
coupon_type
string
The type of coupon like bulk or single
Enum
coupon_prefix
string
Nullable
Bulk coupon code prefix string
coupon_counts
integer
Counts of bulk coupon
Default Value : 1
tags
array of string
List of tags specify to platform
Default Value :
_schedule
object (CouponSchedule)
CouponSchedule
end
string
| date-time
Nullable
The end date of coupon
Default Value : null
start
string
| date-time
Nullable
The start date of coupon
next_schedule
array of object
List of date time, which we will schedule the promotion
cron
string
Nullable
Schedule the cron to run your job periodically
Default Value : null
status
string
Coupon status like draft, review
Default Value : draft
Enum
duration
integer
| int32
Nullable
Time in minutes for execution
Default Value : null
rule
array of object (Rule)
Array of Rule
key
number
| float
Key defines the number of product should be buy for applicability of cart
value
number
| float
value defines discount percentage in coupon
max
number
| float
max defines maximum number of discount amount in coupon
discount_qty
number
| float
discount_qty defines free quantity as discount in coupon
min
number
| float
min defines minimum number of discount amount in coupon
display_meta
object (DisplayMeta)
DisplayMeta
title
string
Coupon title which is used to display
auto
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
apply
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
remove
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
subtitle
string
Coupon sub title which is used to display
description
string
Detail about the offers in coupon
code
string
Unique code of coupon
type_slug
string
The type slug of coupon discount
identifiers
object (Identifier)
Identifier
brand_id
array of integer
List of brand id available for coupon
email_domain
array of string
List of email domain available for coupon
company_id
array of integer
List of company id available for coupon
store_id
array of integer
List of store id available for coupon
collection_id
array of string
List of collection id available for coupon
item_id
array of integer
List of item id available for coupon
user_id
array of string
List of user id available for coupon
category_id
array of integer
List of category id available for coupon
article_id
array of string
List of article id available for coupon
exclude_brand_id
array of integer
List of brand id should not be available for coupon
validity
object (Validity)
Validity
priority
integer
| int32
Priority of coupon to show in list
rule_definition
object (RuleDefinition)
RuleDefinition
currency_code
string
Currency code like INR
Default Value : INR
auto_apply
boolean
Coupon should be auto apply or not
type
string
Type of coupon like absolute, percentage etc.
Enum
is_exact
boolean
Flag is true then use coupon applicable articles for calculation
Default Value : false
applicable_on
string
Coupon will be applicable on either amount or quantity
Enum
calculate_on
string
Article Price on which coupon calculated like effective price or marked price
Enum
value_type
string
Define the type of coupon value
Enum
scope
array of string
List of item level rule applicable for coupon
Enum
_id
string
Unique identifier of coupon
page
object (Page)
Page
item_total
integer
| int32
The total number of items on the page.
next_id
string
The identifier for the next page.
has_previous
boolean
Indicates whether there is a previous page.
has_next
boolean
Indicates whether there is a next page.
current
integer
| int32
The current page number.
type
string
The type of the page, such as 'PageType'.
size
integer
| int32
The number of items per page.
page_size
integer
| int32
The number of items per page.
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
List of coupons
getCoupons
Creates a new coupon based on the selected coupon type. Sellers can choose from multiple supported coupon types, including percentage value, fixed amount value, bundled discount, buy X get Y items, and more, along with customizable coupon criteria to meet specific business requirements.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Request body
date_meta
object (CouponDateMeta)
CouponDateMeta
modified_on
string
| date-time
Nullable
Date time format when the coupon last modified
Default Value : null
created_on
string
| date-time
Nullable
Date time format when the coupon created
Default Value : null
approved_on
string
| date-time
Nullable
Date time format when the coupon approved
Default Value : null
rejected_on
string
| date-time
Nullable
Date time format when the coupon rejected
Default Value : null
reviewed_on
string
| date-time
Nullable
Date time format when the coupon reviewed
Default Value : null
ownership
object (Ownership)
Ownership
payable_category
string
Required
Coupon amount payable category
Enum
payable_by
string
Nullable
Coupon amount bearable party
author
object (CouponAuthor)
CouponAuthor
created_by
string
Nullable
The user id of user, who has created the coupon
Default Value : null
modified_by
string
Nullable
The user id of user, who has modified the coupon
Default Value : null
approved_by
string
Nullable
The user id of user, who has approved the coupon
Default Value : null
rejected_by
string
Nullable
The user id of user, who has rejected the coupon
Default Value : null
reviewed_by
string
Nullable
The user id of user, who has reviewed the coupon
Default Value : null
state
object (State)
State
is_archived
boolean
Publish or unpublish the coupon
Default Value : false
is_display
boolean
Coupon needs to display or not
Default Value : true
is_public
boolean
Coupon is publicaly available or not
Default Value : true
restrictions
object (Restrictions)
Restrictions
payments
object (PaymentModes)
PaymentModes
codes
array of string
Identifier used by payment gateway for a given payment mode, e.g. NB_ICIC, PAYTM
iins
array of string
Debit/Credit card prefix (first 6 digit)
types
array of string
Card type, e.g. Credit, Debit
networks
array of string
Credit/Debit card issuer, e.g. VISA, MASTERCARD, RUPAY
uses
object (PaymentAllowValue)
PaymentAllowValue
max
integer
| int32
Maximum value need to allow for payment
user_type
string
price_range
object (PriceRange)
PriceRange
max
integer
| int32
Max price valid for article in coupon
Default Value : -1
min
integer
| int32
Min price valid for article in coupon
Default Value : -1
platforms
array of string
List of platform on which coupon allowed like web, android
post_order
object (PostOrder)
PostOrder
cancellation_allowed
boolean
Cancellation allowed in coupon
Default Value : true
return_allowed
boolean
Return allowed in coupon
Default Value : true
bulk_bundle
object (BulkBundleRestriction)
BulkBundleRestriction
multi_store_allowed
boolean
Required
Multi store allowed in bulk bundle coupon or not
user_groups
array of integer
List of user group on which coupon allowed
coupon_allowed
boolean
Allow applying normal coupon if bulk coupon is applied
uses
object (UsesRestriction)
UsesRestriction
maximum
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
remaining
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
ordering_stores
array of integer
List of store id on which coupon allowed
validation
object (Validation)
Validation
app_id
array of string
List of sales channel's application id
Default Value :
anonymous
boolean
Coupon applicable for guest user or not
user_registered_after
string
| date-time
Nullable
Coupon applicable for user which is registered after Date Format
Default Value : null
action
object (CouponAction)
CouponAction
action_date
string
| date-time
Nullable
Coupon transaction mode's date time format
Default Value : null
txn_mode
string
Coupon transaction mode like cash, coupon etc
Default Value : coupon
Enum
coupon_type
string
The type of coupon like bulk or single
Enum
coupon_prefix
string
Nullable
Bulk coupon code prefix string
coupon_counts
integer
Counts of bulk coupon
Default Value : 1
tags
array of string
List of tags specify to platform
Default Value :
_schedule
object (CouponSchedule)
CouponSchedule
end
string
| date-time
Nullable
The end date of coupon
Default Value : null
start
string
| date-time
Nullable
The start date of coupon
next_schedule
array of object
List of date time, which we will schedule the promotion
cron
string
Nullable
Schedule the cron to run your job periodically
Default Value : null
status
string
Coupon status like draft, review
Default Value : draft
Enum
duration
integer
| int32
Nullable
Time in minutes for execution
Default Value : null
rule
array of object (Rule)
Array of Rule
key
number
| float
Key defines the number of product should be buy for applicability of cart
value
number
| float
value defines discount percentage in coupon
max
number
| float
max defines maximum number of discount amount in coupon
discount_qty
number
| float
discount_qty defines free quantity as discount in coupon
min
number
| float
min defines minimum number of discount amount in coupon
display_meta
object (DisplayMeta)
DisplayMeta
title
string
Coupon title which is used to display
auto
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
apply
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
remove
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
subtitle
string
Coupon sub title which is used to display
description
string
Detail about the offers in coupon
code
string
Required
Unique code of coupon
type_slug
string
Required
The type slug of coupon discount
identifiers
object (Identifier)
Identifier
brand_id
array of integer
List of brand id available for coupon
email_domain
array of string
List of email domain available for coupon
company_id
array of integer
List of company id available for coupon
store_id
array of integer
List of store id available for coupon
collection_id
array of string
List of collection id available for coupon
item_id
array of integer
List of item id available for coupon
user_id
array of string
List of user id available for coupon
category_id
array of integer
List of category id available for coupon
article_id
array of string
List of article id available for coupon
exclude_brand_id
array of integer
List of brand id should not be available for coupon
validity
object (Validity)
Validity
priority
integer
| int32
Priority of coupon to show in list
rule_definition
object (RuleDefinition)
RuleDefinition
currency_code
string
Currency code like INR
Default Value : INR
auto_apply
boolean
Coupon should be auto apply or not
type
string
Type of coupon like absolute, percentage etc.
Enum
is_exact
boolean
Flag is true then use coupon applicable articles for calculation
Default Value : false
applicable_on
string
Coupon will be applicable on either amount or quantity
Enum
calculate_on
string
Article Price on which coupon calculated like effective price or marked price
Enum
value_type
string
Define the type of coupon value
Enum
scope
array of string
List of item level rule applicable for coupon
Enum
_id
string
Unique identifier of coupon
Response
201
400
Coupon Created successfully
CouponCreateResult
success
boolean
Whether the request was successful (true/false)
message
string
Create coupon response message that can shown to creator user
_id
string
Unique identifier for coupon created
Examples
Parameters
company_id:
"value"
application_id:
"value"
body:
body
Was this section helpful?
POST
Response
Create a coupon
createCoupon
Retrieve details of a specific coupon by providing its unique identifier to obtain information such as coupon type, rules, validity period and other related information.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
Required
Coupon id for fetching single coupon data for editing
Response
200
404
Coupon object for sent coupon id
CouponUpdate
date_meta
object (CouponDateMeta)
CouponDateMeta
modified_on
string
| date-time
Nullable
Date time format when the coupon last modified
Default Value : null
created_on
string
| date-time
Nullable
Date time format when the coupon created
Default Value : null
approved_on
string
| date-time
Nullable
Date time format when the coupon approved
Default Value : null
rejected_on
string
| date-time
Nullable
Date time format when the coupon rejected
Default Value : null
reviewed_on
string
| date-time
Nullable
Date time format when the coupon reviewed
Default Value : null
ownership
object (Ownership)
Ownership
payable_category
string
Coupon amount payable category
Enum
payable_by
string
Nullable
Coupon amount bearable party
author
object (CouponAuthor)
CouponAuthor
created_by
string
Nullable
The user id of user, who has created the coupon
Default Value : null
modified_by
string
Nullable
The user id of user, who has modified the coupon
Default Value : null
approved_by
string
Nullable
The user id of user, who has approved the coupon
Default Value : null
rejected_by
string
Nullable
The user id of user, who has rejected the coupon
Default Value : null
reviewed_by
string
Nullable
The user id of user, who has reviewed the coupon
Default Value : null
state
object (State)
State
is_archived
boolean
Publish or unpublish the coupon
Default Value : false
is_display
boolean
Coupon needs to display or not
Default Value : true
is_public
boolean
Coupon is publicaly available or not
Default Value : true
restrictions
object (Restrictions)
Restrictions
payments
object (PaymentModes)
PaymentModes
codes
array of string
Identifier used by payment gateway for a given payment mode, e.g. NB_ICIC, PAYTM
iins
array of string
Debit/Credit card prefix (first 6 digit)
types
array of string
Card type, e.g. Credit, Debit
networks
array of string
Credit/Debit card issuer, e.g. VISA, MASTERCARD, RUPAY
uses
object (PaymentAllowValue)
PaymentAllowValue
max
integer
| int32
Maximum value need to allow for payment
user_type
string
price_range
object (PriceRange)
PriceRange
max
integer
| int32
Max price valid for article in coupon
Default Value : -1
min
integer
| int32
Min price valid for article in coupon
Default Value : -1
platforms
array of string
List of platform on which coupon allowed like web, android
post_order
object (PostOrder)
PostOrder
cancellation_allowed
boolean
Cancellation allowed in coupon
Default Value : true
return_allowed
boolean
Return allowed in coupon
Default Value : true
bulk_bundle
object (BulkBundleRestriction)
BulkBundleRestriction
multi_store_allowed
boolean
Multi store allowed in bulk bundle coupon or not
user_groups
array of integer
List of user group on which coupon allowed
coupon_allowed
boolean
Allow applying normal coupon if bulk coupon is applied
uses
object (UsesRestriction)
UsesRestriction
maximum
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
remaining
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
ordering_stores
array of integer
List of store id on which coupon allowed
validation
object (Validation)
Validation
app_id
array of string
List of sales channel's application id
Default Value :
anonymous
boolean
Coupon applicable for guest user or not
user_registered_after
string
| date-time
Nullable
Coupon applicable for user which is registered after Date Format
Default Value : null
action
object (CouponAction)
CouponAction
action_date
string
| date-time
Nullable
Coupon transaction mode's date time format
Default Value : null
txn_mode
string
Coupon transaction mode like cash, coupon etc
Default Value : coupon
Enum
tags
array of string
List of tags specify to platform
Default Value :
_schedule
object (CouponSchedule)
CouponSchedule
end
string
| date-time
Nullable
The end date of coupon
Default Value : null
start
string
| date-time
Nullable
The start date of coupon
next_schedule
array of object
List of date time, which we will schedule the promotion
cron
string
Nullable
Schedule the cron to run your job periodically
Default Value : null
status
string
Coupon status like draft, review
Default Value : draft
Enum
duration
integer
| int32
Nullable
Time in minutes for execution
Default Value : null
rule
array of object (Rule)
Array of Rule
key
number
| float
Key defines the number of product should be buy for applicability of cart
value
number
| float
value defines discount percentage in coupon
max
number
| float
max defines maximum number of discount amount in coupon
discount_qty
number
| float
discount_qty defines free quantity as discount in coupon
min
number
| float
min defines minimum number of discount amount in coupon
display_meta
object (DisplayMeta)
DisplayMeta
title
string
Coupon title which is used to display
auto
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
apply
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
remove
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
subtitle
string
Coupon sub title which is used to display
description
string
Detail about the offers in coupon
code
string
Unique code that is used to apply coupon
coupon_type
string
The type of coupon like bulk or single
Enum
coupon_prefix
string
Nullable
Bulk coupon code prefix string
coupon_counts
integer
Counts of culk coupon
Default Value : 1
reason
string
Nullable
Coupon rejection reason added by reviewer
type_slug
string
The type slug of coupon discount
identifiers
object (Identifier)
Identifier
brand_id
array of integer
List of brand id available for coupon
email_domain
array of string
List of email domain available for coupon
company_id
array of integer
List of company id available for coupon
store_id
array of integer
List of store id available for coupon
collection_id
array of string
List of collection id available for coupon
item_id
array of integer
List of item id available for coupon
user_id
array of string
List of user id available for coupon
category_id
array of integer
List of category id available for coupon
article_id
array of string
List of article id available for coupon
exclude_brand_id
array of integer
List of brand id should not be available for coupon
validity
object (Validity)
Validity
priority
integer
| int32
Priority of coupon to show in list
rule_definition
object (RuleDefinition)
RuleDefinition
currency_code
string
Currency code like INR
Default Value : INR
auto_apply
boolean
Coupon should be auto apply or not
type
string
Type of coupon like absolute, percentage etc.
Enum
is_exact
boolean
Flag is true then use coupon applicable articles for calculation
Default Value : false
applicable_on
string
Coupon will be applicable on either amount or quantity
Enum
calculate_on
string
Article Price on which coupon calculated like effective price or marked price
Enum
value_type
string
Define the type of coupon value
Enum
scope
array of string
List of item level rule applicable for coupon
Enum
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
Was this section helpful?
GET
Response
Get a coupon
getCouponById
Update the details of an existing coupon by specifying its unique identifier. This includes modifying coupon attributes such as discount percentage, validity period, and associated conditions. Leveraging this functionality allows businesses to quickly adapt their promotional strategies to changing market dynamics.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
Required
Coupon id for fetching single coupon data for editing
Request body
date_meta
object (CouponDateMeta)
CouponDateMeta
modified_on
string
| date-time
Nullable
Date time format when the coupon last modified
Default Value : null
created_on
string
| date-time
Nullable
Date time format when the coupon created
Default Value : null
approved_on
string
| date-time
Nullable
Date time format when the coupon approved
Default Value : null
rejected_on
string
| date-time
Nullable
Date time format when the coupon rejected
Default Value : null
reviewed_on
string
| date-time
Nullable
Date time format when the coupon reviewed
Default Value : null
ownership
object (Ownership)
Ownership
payable_category
string
Required
Coupon amount payable category
Enum
payable_by
string
Nullable
Coupon amount bearable party
author
object (CouponAuthor)
CouponAuthor
created_by
string
Nullable
The user id of user, who has created the coupon
Default Value : null
modified_by
string
Nullable
The user id of user, who has modified the coupon
Default Value : null
approved_by
string
Nullable
The user id of user, who has approved the coupon
Default Value : null
rejected_by
string
Nullable
The user id of user, who has rejected the coupon
Default Value : null
reviewed_by
string
Nullable
The user id of user, who has reviewed the coupon
Default Value : null
state
object (State)
State
is_archived
boolean
Publish or unpublish the coupon
Default Value : false
is_display
boolean
Coupon needs to display or not
Default Value : true
is_public
boolean
Coupon is publicaly available or not
Default Value : true
restrictions
object (Restrictions)
Restrictions
payments
object (PaymentModes)
PaymentModes
codes
array of string
Identifier used by payment gateway for a given payment mode, e.g. NB_ICIC, PAYTM
iins
array of string
Debit/Credit card prefix (first 6 digit)
types
array of string
Card type, e.g. Credit, Debit
networks
array of string
Credit/Debit card issuer, e.g. VISA, MASTERCARD, RUPAY
uses
object (PaymentAllowValue)
PaymentAllowValue
max
integer
| int32
Maximum value need to allow for payment
user_type
string
price_range
object (PriceRange)
PriceRange
max
integer
| int32
Max price valid for article in coupon
Default Value : -1
min
integer
| int32
Min price valid for article in coupon
Default Value : -1
platforms
array of string
List of platform on which coupon allowed like web, android
post_order
object (PostOrder)
PostOrder
cancellation_allowed
boolean
Cancellation allowed in coupon
Default Value : true
return_allowed
boolean
Return allowed in coupon
Default Value : true
bulk_bundle
object (BulkBundleRestriction)
BulkBundleRestriction
multi_store_allowed
boolean
Required
Multi store allowed in bulk bundle coupon or not
user_groups
array of integer
List of user group on which coupon allowed
coupon_allowed
boolean
Allow applying normal coupon if bulk coupon is applied
uses
object (UsesRestriction)
UsesRestriction
maximum
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
remaining
object (UsesRemaining)
UsesRemaining
user
integer
| int32
Define total coupon count per user
total
integer
| int32
Define total coupon counts
app
integer
| int32
Define coupon counts associated with application id
ordering_stores
array of integer
List of store id on which coupon allowed
validation
object (Validation)
Validation
app_id
array of string
List of sales channel's application id
Default Value :
anonymous
boolean
Coupon applicable for guest user or not
user_registered_after
string
| date-time
Nullable
Coupon applicable for user which is registered after Date Format
Default Value : null
action
object (CouponAction)
CouponAction
action_date
string
| date-time
Nullable
Coupon transaction mode's date time format
Default Value : null
txn_mode
string
Coupon transaction mode like cash, coupon etc
Default Value : coupon
Enum
tags
array of string
List of tags specify to platform
Default Value :
_schedule
object (CouponSchedule)
CouponSchedule
end
string
| date-time
Nullable
The end date of coupon
Default Value : null
start
string
| date-time
Nullable
The start date of coupon
next_schedule
array of object
List of date time, which we will schedule the promotion
cron
string
Nullable
Schedule the cron to run your job periodically
Default Value : null
status
string
Coupon status like draft, review
Default Value : draft
Enum
duration
integer
| int32
Nullable
Time in minutes for execution
Default Value : null
rule
array of object (Rule)
Array of Rule
key
number
| float
Key defines the number of product should be buy for applicability of cart
value
number
| float
value defines discount percentage in coupon
max
number
| float
max defines maximum number of discount amount in coupon
discount_qty
number
| float
discount_qty defines free quantity as discount in coupon
min
number
| float
min defines minimum number of discount amount in coupon
display_meta
object (DisplayMeta)
DisplayMeta
title
string
Coupon title which is used to display
auto
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
apply
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
remove
object (DisplayMetaDict)
DisplayMetaDict
title
string
Coupon title which is used to display
subtitle
string
Coupon sub title which is used to display
subtitle
string
Coupon sub title which is used to display
description
string
Detail about the offers in coupon
code
string
Required
Unique code that is used to apply coupon
coupon_type
string
The type of coupon like bulk or single
Enum
coupon_prefix
string
Nullable
Bulk coupon code prefix string
coupon_counts
integer
Counts of culk coupon
Default Value : 1
reason
string
Nullable
Coupon rejection reason added by reviewer
type_slug
string
Required
The type slug of coupon discount
identifiers
object (Identifier)
Identifier
brand_id
array of integer
List of brand id available for coupon
email_domain
array of string
List of email domain available for coupon
company_id
array of integer
List of company id available for coupon
store_id
array of integer
List of store id available for coupon
collection_id
array of string
List of collection id available for coupon
item_id
array of integer
List of item id available for coupon
user_id
array of string
List of user id available for coupon
category_id
array of integer
List of category id available for coupon
article_id
array of string
List of article id available for coupon
exclude_brand_id
array of integer
List of brand id should not be available for coupon
validity
object (Validity)
Validity
priority
integer
| int32
Priority of coupon to show in list
rule_definition
object (RuleDefinition)
RuleDefinition
currency_code
string
Currency code like INR
Default Value : INR
auto_apply
boolean
Coupon should be auto apply or not
type
string
Type of coupon like absolute, percentage etc.
Enum
is_exact
boolean
Flag is true then use coupon applicable articles for calculation
Default Value : false
applicable_on
string
Coupon will be applicable on either amount or quantity
Enum
calculate_on
string
Article Price on which coupon calculated like effective price or marked price
Enum
value_type
string
Define the type of coupon value
Enum
scope
array of string
List of item level rule applicable for coupon
Enum
Response
200
404
Coupon updated successfully
CouponCreateResult
success
boolean
Whether the request was successful (true/false)
message
string
Create coupon response message that can shown to creator user
_id
string
Unique identifier for coupon created
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
body:
body
Was this section helpful?
PUT
Response
Update a coupon
updateCoupon
Delete details of a draft coupon by providing its unique identifier to delete information such as coupon type, rules, validity period and other related information.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Application id of sales channel
id
string
Required
Coupon id for fetching single coupon data for deleting
Response
200
404
Coupon deleted for sent coupon id
SuccessMessage
success
boolean
Whether the request was successful (true/false).
message
string
Response message needs to display
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
Was this section helpful?
DEL
Response
Delete a coupon which is in draft state
deleteCoupon
Validates the presence of a coupon code for the specified sales channel to verify whether the provided code already exists or not.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
code
string
Coupon code
Response
200
400
Valid response with existing coupon code count
Properties
success
boolean
count
integer
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
Response
Check coupon code exists
getCouponCodeExists
Retrieve a list of 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
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
id
string
The unique identifier of the cart.
buy_now
boolean
This is boolean to get buy_now cart
slug
string
Product slug to fetch the available coupons
store_id
string
Store id
Response
200
Success. Returns a coupon object which has a list of all the eligible coupons. Refer `GetCouponResult` for more details.
GetCouponResult
available_coupon_list
array of object (Coupon)
List of available coupon which can be applied on cart
Array of Coupon
title
string
Coupon Title of the coupon applied denotes name of the coupon
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_applied
boolean
Flag to determine where the coupon is applied to cart or not
coupon_type
string
Nullable
Type of the coupon applied to cart
expires_on
string
Message to display to user for expiry of the coupon
coupon_value
number
| float
Coupon value of the coupon applied to cart
sub_title
string
Coupon subtitle of the coupon applied to cart which is used to display
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
is_applicable
boolean
Flag to determine where the coupon is applicable to cart or not
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart
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
page
object (PageCoupon)
PageCoupon
has_next
boolean
Denotes if next page of coupon is available
current
integer
| int32
Current page number
total
integer
| int32
Total pages of coupon availalbe
total_item_count
integer
| int32
Total coupons are available for the cart
has_previous
boolean
Denotes if previous page of the coupon is available
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
buy_now:
false
slug:
"value"
store_id:
"value"
Was this section helpful?
GET
Response
List of coupons
getAppCoupons
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
i
boolean
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
p
boolean
This is a boolean value. 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
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
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
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
Examples
Parameters
company_id:
"value"
application_id:
"value"
i:
false
b:
false
p:
false
id:
"value"
buy_now:
false
body:
body
x-ordering-source:
"default"
Was this section helpful?
POST
Response
Apply coupon
applyCoupon
Remove an applied coupon from the customer's cart, thereby removing the associated discount from the cart total.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
uid
string
The unique identifier of the cart
buy_now
boolean
This is boolean to get buy_now cart
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
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
coupon_text
string
Coupon text of coupon applied on cart
id
string
Unique identifier of the user cart
pan_config
object
Pan card config states at what condition user should enter the pan card
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
quantity
integer
| int32
Quantity of the product added in cart
product
object (CartProduct)
CartProduct
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
url
string
Bucket link url for product image
aspect_ratio
string
Aspect ratio of the product image
teaser_tag
object (Tags)
Tags
tags
object
Tags is a lable or batch that is attached to a 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
type
string
Type of action
url
string
Url of the product to render the product
query
object (ActionQuery)
ActionQuery
product_slug
array of string
Contains list of product slug
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.
uid
integer
| int32
Unique identifier of the product in cart
tags
array of string
Products tags that are added to each product to identify the set of products
_custom_json
object
Field to add custom json of the product in cart
type
string
Type of 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
Unique identifier of Product Category
name
string
Category name of the product
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)
parent_item_identifiers
object
Parent item information of the product which identifies the parent of the product in cart
is_set
boolean
Whether or not the product is a set of items
article
object (ProductArticle)
ProductArticle
seller_identifier
string
List of identifiers used by sellers for the product size.
quantity
integer
| int32
Quantity of the article added in cart
seller
object (BaseInfo)
BaseInfo
uid
integer
| int32
Unique identifier of entities like brand or seller
name
string
Name of entities like brand or seller
cart_item_meta
object
Meta details of the article added from cart
parent_item_identifiers
object
Fields to determine parent product of the product
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.
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
product_group_tags
array of string
List fot the unique identifier for the product grouping.
identifier
object
Unique identifier of the article
mto_quantity
integer
| int32
Quantity of the product which will specially manufactured as not available in stock
extra_meta
object
Field to update extra meta of the article in cart
type
string
Type of the data sent in response. Possible value is article
_custom_json
object
Field to update custom json of the article in cart
price
object (ArticlePriceInfo)
ArticlePriceInfo
converted
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
base
object (BasePrice)
BasePrice
effective
number
| float
Current per unit price of product after existing deductions
currency_code
string
Currency code for all amounts
currency_symbol
string
currency symbol of the currncy used for price
marked
number
| float
Original price of product
meta
object
Meta data of article in cart
size
string
Size of the article added in cart
store
object (StoreInfo)
StoreInfo
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
store_code
string
A unique code or identifier for the store, often used for internal reference
tags
array of string
A list of article tags
promotions_applied
array of object (AppliedPromotion)
List of applicable promotion for the product in cart
Array of AppliedPromotion
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
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.
key
string
The attribute key associated with the size
coupon
object (CouponDetails)
CouponDetails
discount_total_quantity
number
| float
Total discount earned from coupon applied to cart
discount_single_quantity
number
| float
Discout amount applied from coupon for single quantity of the product
code
string
Coupon code of the coupon applied
bulk_offer
object
Bulk offer information for the product which denotes if any bulk offer is applied to the product in cart
price
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
coupon_message
string
Message for the coupon denotes which coupon is applied and empty if not applied
identifiers
object (CartProductIdentifer)
CartProductIdentifer
identifier
string
Article idenfier generated by cart
message
string
Product level message which denotes error information to display over the product in cart
discount
string
Discount amount of the product in cart
availability
object (ProductAvailability)
ProductAvailability
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
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
out_of_stock
boolean
Denotes if the product is available in stock
sizes
array of string
All sizes of the product
moq
object
An Integer indication the Minimum Order Quantity of a product, e.g. 100.
max_quantity
object (ProductMaxQuantityInfo)
ProductMaxQuantityInfo
item
number
Nullable
The total quantity of the item available across all stores for all sellers. If no data is available, this field will be null.
item_seller
number
Nullable
The total quantity of the item available across all stores for the specified seller. If no seller data is available, this field will be null.
item_store
number
Nullable
The total quantity of the item available for a specific store. If no store data is available, this field will be null.
price_per_unit
object (ProductPriceInfo)
ProductPriceInfo
converted
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
base
object (ProductPrice)
ProductPrice
marked
number
| float
Maximum price of the product
add_on
number
| float
Price before promotion and coupon amount applied for calculation
currency_code
string
currency code of the price defined for the product
currency_symbol
string
currency symbol of the price defined for the product
effective
number
| float
Selling price of the product
selling
number
| float
Selling price of the product
promo_meta
object (PromoMeta)
PromoMeta
message
string
Loyalty points message denotes how much loyalty points and applied and how much left with the user
custom_order
object
Whether MTO (Make to Order) is enabled or not.
payment_selection_lock
object (PaymentSelectionLock)
PaymentSelectionLock
payment_identifier
string
Identifier for Payment Mode
default_options
string
Default Selection Payment Mode
enabled
boolean
Denotes if default payment selection is enable
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
restrict_checkout
boolean
Restrict checkout flag to restrict the checkout process
message
string
Message of the 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
breakup_values
object (CartBreakup)
CartBreakup
coupon
object (CouponBreakup)
CouponBreakup
title
string
Nullable
Coupon Title of the coupon applied denotes name of the coupon
max_discount_value
number
| float
Maximum discount value of the coupon applied to cart
value
number
| float
Coupon value of the coupon applied to cart
is_applied
boolean
Applied flag which denotes if any coupon is applied to cart
uid
string
Unique identifier of the coupon applied to cart
coupon_type
string
Nullable
Type of the coupon applied to cart
sub_title
string
Nullable
Coupon subtitle of the coupon applied to cart which is used to display
coupon_value
number
| float
Value of the coupon applied to cart
code
string
Coupon code of the coupon applied
type
string
Type of the coupon applied to cart
minimum_cart_value
number
| float
Minimum cart value of the coupon applied to cart
message
string
Coupon message of the coupon applied to cart
description
string
Nullable
Coupon description of the coupon applied to cart.
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
key
string
key of the price like total_mrp, total, subtotal etc
value
number
| float
Numeric value for the price
currency_code
string
Currency code for the price
currency_symbol
string
Currency symbol for the price
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
loyalty_points
object (LoyaltyPoints)
LoyaltyPoints
is_applied
boolean
Whether the loyalty points are applied on the cart
total
number
| float
Total loyalty points available with user
applicable
number
| float
Whether the loyalty points are applicable for the cart
description
string
Description for loyalty points
raw
object (RawBreakup)
RawBreakup
coupon
number
| float
Coupon amount 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
fynd_cash
number
| float
Loyalty points applied on cart
vog
number
| float
Total value of goods after all discount, coupons and promotion applied of all products in cart
gift_card
number
| float
Gift cart amount applied on cart
cod_charge
number
| float
Cod charge value applied to cart. This is applied when user select payment mode as COD
total
number
| float
Total payable amount by the customer
discount
number
| float
Discount amount recieved on cart
delivery_charge
number
| float
Delivery charge applied to cart
you_saved
number
| float
Total amount will be saved if customer places the order
subtotal
number
| float
Selling price amount of all products in cart
convenience_fee
number
| float
Convenience fee amount applied to cart
is_valid
boolean
Cart validity flag determines the if the response is valid or not
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
checkout_mode
string
Checkout mode of user cart
last_modified
string
| date
Last modified timestamp of cart
buy_now
boolean
Buy now flag for the cart which denotes user is doing fast checkout for the cart using buy now
gstin
string
GSTIN added in 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
article_quantity
integer
| int32
Quantity of article on which promotion is applicable
ownership
object (Ownership2)
Ownership of promotion
Ownership2
payable_category
string
Promotion amount payable category
payable_by
string
Promotion amount bearable party
currency
object (CartCurrency)
CartCurrency
code
string
Currency code defined by ISO 4217:2015
symbol
string
Currency symbol for currency of user cart prices
discount_rules
array of object (DiscountRulesApp)
Discount rules for promotions
Array of DiscountRulesApp
offer
object
Offer detail for promotion
raw_offer
object
Raw offer details for promotion
item_criteria
object
Item criteria of promotion
matched_buy_rules
array of string
Matched buy rules for promotion
applied_free_articles
array of object (AppliedFreeArticles)
Applied free article for free gift item promotions
Array of AppliedFreeArticles
parent_item_identifier
string
Parent item identifier for free article
quantity
integer
| int32
Free article quantity in promotion
article_id
string
Unique identifier of free article
free_gift_item_details
object (FreeGiftItems)
Free gift items details in promotion
FreeGiftItems
item_slug
string
Free gift product slug
item_name
string
Free gift product name
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
The currency code for price
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
Free gift product brand name
item_id
integer
| int32
Free gift product id
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
List of free gift product images URL
promotion_name
string
Promotion name of current promotion
buy_rules
array of object (BuyRules)
Buy rules for promotions
Array of BuyRules
cart_conditions
object
Cart conditions details for promotion
item_criteria
object
Item criteria of promotion
offer_text
string
Offer text of current promotion
offer_label
string
Offer label of the applied promotion, to be used as display text.
amount
number
| float
Per unit discount amount applied with current promotion
float_amount
string
Per unit discount amount with decimal values applied with current promotion.
promotion_type
string
Promotion type of current promotion
Enum
mrp_promotion
boolean
If applied promotion is applied on product MRP or ESP
promotion_group
string
Promotion group for the promotion
promo_id
string
Promotion unique identifier
meta
object
Meta object for extra data
code
string
Nullable
Promotion unique code
pan_no
string
Permanent Account Number of the user
custom_cart_meta
object
Custom meta details added cart checkout API payload
Examples
Parameters
company_id:
"value"
application_id:
"value"
uid:
"value"
buy_now:
false
x-ordering-source:
"default"
Was this section helpful?
DEL
Response
Remove coupon
removeCoupon
Validates 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
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
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 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
Headers
x-ordering-source
object (OrderingSource)
Ordering source header, to be used to identify source of order creation.
Enum
Response
200
Success. Returns a success message and the coupon validity. Refer `PaymentCouponValidate` for more details.
PaymentCouponValidate
success
boolean
success flag of coupon payment mode validity API response
message
string
Payment mode valid message for coupon
coupon_validity
object (CouponValidity)
CouponValidity
title
string
Coupon Title 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
discount
number
| float
Coupon discount value of the coupon applied
error_en
string
Nullable
Error message for the selected payment mode.
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
buy_now:
false
address_id:
"value"
payment_mode:
"value"
payment_identifier:
"value"
aggregator_name:
"value"
merchant_code:
"value"
x-ordering-source:
"default"
Was this section helpful?
GET
Response
Validate applied coupon
validateCouponForPayment
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
Retrieves a list of all addresses saved by the customer, simplifying the checkout process by offering pre-saved address options for delivery.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
cart_id
string
The unique identifier of the cart
buy_now
boolean
This is boolean to get buy_now cart
mobile_no
string
10-digit mobile number of the customer
checkout_mode
string
Option to checkout for `self` or for `others`. By default, it is `self`.
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.
user_id
string
Option to fetch address for the provided user_id.
Response
200
400
Success. Returns an Address object containing a list of address saved in the account. Refer `PlatformGetAddressesDetails` for more details.
PlatformGetAddressesDetails
pii_masking
boolean
Personally Identifiable Information masking flag to denote if the user data in address is masked or not.
address
array of object (PlatformAddress)
List of all address saved by customer
Array of PlatformAddress
phone
string
Phone number for address
id
string
Id of the address
area_code_slug
string
Area code slug for address. example pincode is slug for India
country_code
string
Country code of address
geo_location
object (GeoLocation)
GeoLocation
longitude
number
| float
Longitude coordinate for address
Default Value : 0
latitude
number
| float
Latitude coordinate for address
Default Value : 0
country
string
Country of address
state
string
State of the address
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected
tags
array of string
Tags of address from which it can be identified
created_by_user_id
string
Created by user id of address
landmark
string
Landmark of address
email
string
Email address for address data
area_code
string
Area code of the address
checkout_mode
string
Checkout mode of address on which address to be used for which checkout mode of cart
meta
object
Metadata of the address
is_active
boolean
States whether address is active or not
name
string
Name of person in address data to whom it belongs to
google_map_point
object
Google map point of the address
cart_id
string
The cart id of user cart
city
string
City of the address
sector
string
Sector of the address
state_code
string
State code for international address
area
string
Area description for address
user_id
string
User id of address for which address is created
address_type
string
Address type of address
address
string
Address description for address data
country_phone_code
string
Country phone code for address
country_iso_code
string
Country iso code for address
_custom_json
object
Custom json 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
Get a list of addresses for a customer
getAddresses
Customers can add a new address to their cart to save details such as name, email, contact information, and address.
Parameters
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
Request body
phone
string
Phone number for address
id
string
Id of the address
area_code_slug
string
Area code slug for address. example pincode is slug for India
country_code
string
Country code of address
geo_location
object (GeoLocation)
GeoLocation
longitude
number
| float
Longitude coordinate for address
Default Value : 0
latitude
number
| float
Latitude coordinate for address
Default Value : 0
country
string
Country of address
state
string
State of the address
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected
tags
array of string
Tags of address from which it can be identified
created_by_user_id
string
Created by user id of address
landmark
string
Landmark of address
email
string
Email address for address data
area_code
string
Area code of the address
checkout_mode
string
Checkout mode of address on which address to be used for which checkout mode of cart
meta
object
Metadata of the address
is_active
boolean
States whether address is active or not
name
string
Name of person in address data to whom it belongs to
google_map_point
object
Google map point of the address
cart_id
string
The cart id of user cart
city
string
City of the address
sector
string
Sector of the address
state_code
string
State code for international address
area
string
Area description for address
user_id
string
User id of address for which address is created
address_type
string
Address type of address
address
string
Address description for address data
country_phone_code
string
Country phone code for address
country_iso_code
string
Country iso code for address
_custom_json
object
Custom json of the address
Response
200
400
422
Success. Returns the address ID, a flag whether the address is set as default, and a success message. Refer `SaveAddressDetails` for more details.
SaveAddressDetails
id
string
Id of the address
success
boolean
Success flag of save address Response
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
Creates a new address for a customer
addAddress
Retrieve 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
company_id
string
Required
Current company id
application_id
string
Required
Current Application id of sales channel
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
10-digit 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.
user_id
string
Option to fetch address for the provided user_id.
Response
200
400
Success. Returns an PlatformAddress object containing a list of address saved in the account. Refer `PlatformAddress` for more details.
PlatformAddress
phone
string
Phone number for address
id
string
Id of the address
area_code_slug
string
Area code slug for address. example pincode is slug for India
country_code
string
Country code of address
geo_location
object (GeoLocation)
GeoLocation
longitude
number
| float
Longitude coordinate for address
Default Value : 0
latitude
number
| float
Latitude coordinate for address
Default Value : 0
country
string
Country of address
state
string
State of the address
is_default_address
boolean
Default address flag if no address selected then this should be the default address selected
tags
array of string
Tags of address from which it can be identified
created_by_user_id
string
Created by user id of address
landmark
string
Landmark of address
email
string
Email address for address data
area_code
string
Area code of the address
checkout_mode
string
Checkout mode of address on which address to be used for which checkout mode of cart
meta
object
Metadata of the address
is_active
boolean
States whether address is active or not
name
string
Name of person in address data to whom it belongs to
google_map_point
object
Google map point of the address
cart_id
string
The cart id of user cart
city
string
City of the address
sector
string
Sector of the address
state_code
string
State code for international address
area
string
Area description for address
user_id
string
User id of address for which address is created
address_type
string
Address type of address
address
string
Address description for address data
country_phone_code
string
Country phone code for address
country_iso_code
string
Country iso code for address
_custom_json
object
Custom json of the address
Examples
Parameters
company_id:
"value"
application_id:
"value"
id:
"value"
cart_id:
"value"
buy_now:
false
mobile_no:
"value"
checkout_mode:
"value"
tags:
"value"
is_default:
false
user_id:
"value"
Was this section helpful?
GET
Response