Skip to main content

Cart

Handles shopping carts, including adding, removing, and updating items, as well as calculating totals.

Cart

Cart provides detailed information about selected items, including their name, quantity, price breakup, applied discounts, and any relevant attributes like size, product image, or tags. It also displays availability status, estimated shipping time, and seller information. This helps customers track their products throughout the order journey.

Operations
GET
/service/application/cart/v1.0/detail
# Get a cart
HEAD
/service/application/cart/v1.0/detail
# Get last modified timestamp of a cart
POST
/service/application/cart/v1.0/detail
# Add items to a cart
PUT
/service/application/cart/v1.0/detail
# Update cart items
PUT
/service/application/cart/v1.0/cart_archive
# Delete a cart
GET
/service/application/cart/v1.0/basic
# Get a cart items count
PUT
/service/application/cart/v1.0/meta
# Update cart metadata
POST
/service/application/cart/v1.0/share-cart
# Create share cart link
GET
/service/application/cart/v1.0/share-cart/{token}
# List shared cart items
POST
/service/application/cart/v1.0/share-cart/{token}/{action}
# Update with shared items
GET

Get a cart

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
id
string
Optional
The unique identifier of the cart
i
boolean
Optional
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
Optional
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
c
boolean
Optional
This is a boolean value. Select `true` to retrieve the cod charges in breakup of cart items.
assignCardId
integer
Optional
Token of user's debit or credit card
areaCode
string
Optional
Customer servicable area_code
buyNow
boolean
Optional
This is a boolen value. Select `true` to set/initialize buy now cart
Response
200
Success. Returns a Cart object. Check the example shown below or refer `CartDetailResponse` for more details.
CartDetailResponse
cart_id
integer
| int32
Optional
uid
string
Optional
applied_promo_details
array of object (AppliedPromotion)
Optional
Array of AppliedPromotion
checkout_mode
string
Optional
pan_no
string
Optional
is_valid
boolean
Optional
id
string
Optional
payment_selection_lock
object (PaymentSelectionLock)
Optional
PaymentSelectionLock
delivery_promise
object (ShipmentPromise)
Optional
ShipmentPromise
comment
string
Optional
items
array of object (CartProductInfo)
Optional
Array of CartProductInfo
delivery_charge_info
string
Optional
common_config
object (CartCommonConfig)
Optional
CartCommonConfig
coupon
object (CartDetailCoupon)
Optional
CartDetailCoupon
message
string
Optional
notification
object
Optional
staff_user_id
string
Optional
success
boolean
Optional
gstin
string
Optional
restrict_checkout
boolean
Optional
last_modified
string
| date-time
Optional
breakup_values
object (CartBreakup)
Optional
CartBreakup
currency
object (CartCurrency)
Optional
CartCurrency
coupon_text
string
Optional
buy_now
boolean
Optional
pan_config
object
Optional
Examples
Parameters
id:
"value"
i:
false
b:
false
c:
false
assignCardId:
0
areaCode:
"value"
buyNow:
false
Was this section helpful?
GET
/service/application/cart/v1.0/detail
Loading...
Response
Loading...
HEAD

Get last modified timestamp of a cart

Retrieve the last modified timestamp of the cart using unique cart ID. It indicates the most recent update made to the cart's content or properties.
Parameters
id
string
Optional
The unique identifier of the cart
Response
200
Success. Receives last modifed timestamp in the header.
Header Items
Last-Modified
string
| date
Optional
Last-Modified Action on Cart
Examples
Parameters
id:
"value"
Was this section helpful?
HEAD
/service/application/cart/v1.0/detail
Loading...
Response
Example response not available.
POST

Add items to a cart

Add product items to the customer's existing shopping cart. If there is no existing cart associated with the customer, it creates a new one and adds the items to it.
Parameters
i
boolean
Optional
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
Optional
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
areaCode
string
Optional
Customer servicable area_code
buyNow
boolean
Optional
This is a boolen value. Select `true` to set/initialize buy now cart
id
string
Optional
The unique identifier of the cart
body
object (AddCartRequest)
Specify the item details as shown below. Refer `AddCartRequest` for more details.
AddCartRequest
items
array of object (AddProductCart)
Optional
Array of AddProductCart
new_cart
boolean
Optional
Response
200
Success. Returns a cart object as shown below. Refer `AddCartDetailResponse` for more details.
AddCartDetailResponse
message
string
Optional
partial
boolean
Optional
When adding multiple items check if all added. True if only few are added.
cart
object (CartDetailResponse)
Optional
CartDetailResponse
success
boolean
Optional
True if all items are added successfully. False if partially added or not added.
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
/service/application/cart/v1.0/detail
Loading...
Response
Loading...
PUT

Update cart items

Customers can modify added product attributes such as quantity and size, as well as remove items from the cart.
Parameters
id
string
Optional
The unique identifier of the cart
i
boolean
Optional
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
Optional
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
areaCode
string
Optional
Customer servicable area_code
buyNow
boolean
Optional
This is a boolen value. Select `true` to set/initialize buy now cart
cartType
string
Optional
The type of cart
body
object (UpdateCartRequest)
Specify the item details and operation as shown below. Refer `UpdateCartRequest` for more details.
UpdateCartRequest
items
array of object (UpdateProductCart)
Optional
Array of UpdateProductCart
operation
string
Enum
Response
200
Success. Updates and returns a cart object as shown below. Refer `UpdateCartDetailResponse` for more details.
UpdateCartDetailResponse
message
string
Optional
cart
object (CartDetailResponse)
Optional
CartDetailResponse
success
boolean
Optional
True if all items are added successfully. False if partially added or not added.
Examples
Parameters
Parameters are not required.
Was this section helpful?
PUT
/service/application/cart/v1.0/detail
Loading...
Response
Loading...
PUT

Delete a cart

Delete all items from the user's cart and resets it to its initial state, providing a clean slate for new selections.
Parameters
id
string
Optional
The unique identifier of the cart.
Response
200
Success. Returns whether the cart has been deleted or not.
DeleteCartDetailResponse
message
string
Optional
success
boolean
Optional
True if cart is archived successfully. False if not archived.
Examples
Parameters
id:
"value"
Was this section helpful?
PUT
/service/application/cart/v1.0/cart_archive
Loading...
Response
Loading...
GET

Get a cart items count

Retrieve the total count of items currently present in the customer's cart.
Parameters
id
string
Optional
The unique identifier of the cart.
buyNow
boolean
Optional
Boolean value to get buy_now cart.
Response
200
Success. Returns the total count of items in a user's cart.
CartItemCountResponse
user_cart_items_count
integer
| int32
Optional
Item count present in cart
Examples
Parameters
id:
"value"
buyNow:
false
Was this section helpful?
GET
/service/application/cart/v1.0/basic
Loading...
Response
Loading...
PUT

Update cart metadata

Add or modify metadata associated with a cart, which includes customer preferences, delivery instructions, or any special requirements related to the cart items.
Parameters
id
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
this is boolean to get buy_now cart
body
object (CartMetaRequest)
gstin: Pass gstin number to claim GST credit, e.g. 27AAPFU0939F1ZV checkout_mode: Pass checkout mode for current order as described below. self: Customer him self placing order staff:Placing order on behalf of customer comment: Set comments to be passed to order team during adding items, e.g. leave the package with my neighbour.
CartMetaRequest
delivery_slots
object
Optional
gift_details
object (ArticleGiftDetail)
Optional
ArticleGiftDetail
pick_up_customer_details
object
Optional
Customer contact details for customer pickup at store
checkout_mode
string
Optional
comment
string
Optional
gstin
string
Optional
Response
200
400
Returns a message indicating the success of cart meta updation as shown below.
CartMetaResponse
message
string
Optional
is_valid
boolean
Optional
Examples
Parameters
id:
"value"
buyNow:
false
body:
body
Was this section helpful?
PUT
/service/application/cart/v1.0/meta
Loading...
Response
Loading...
GET

List shared cart items

Retrieve the cart items from the shared cart link based on unique token.
Parameters
token
string
Token of the shared short link
Response
200
404
Success. Returns a Cart object as per the valid token. Refer `SharedCartResponse` for more details.
SharedCartResponse
error
string
Optional
cart
object (SharedCart)
Optional
SharedCart
Examples
Parameters
token:
"value"
Was this section helpful?
GET
/service/application/cart/v1.0/share-cart/{token}
Loading...
Response
Loading...
POST

Update with shared items

Customer can either merge or replace shared cart items with existing cart.
Parameters
token
string
Token of the shared short link
action
string
Operation to perform on the existing cart merge or replace.
Enum
Response
200
Success. Returns a merged or replaced cart as per the valid token. Refer `SharedCartResponse` for more details.
SharedCartResponse
error
string
Optional
cart
object (SharedCart)
Optional
SharedCart
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
/service/application/cart/v1.0/share-cart/{token}/{action}
Loading...
Response
Loading...

Checkout

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
/service/application/cart/v1.0/checkout
# Checkout cart
POST
/service/application/cart/v2.0/checkout
# Start cart checkout (latest)
POST

Checkout cart

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
buyNow
boolean
Optional
This indicates the type of cart to checkout
cartType
string
Optional
The type of cart
body
object (CartCheckoutDetailRequest)
Check the example shown below or refer `CartCheckoutDetailRequest` for more details.
CartCheckoutDetailRequest
custom_meta
array of object (CartCheckoutCustomMeta)
Optional
Array of CartCheckoutCustomMeta
customer_details
object (CustomerDetails)
Optional
Customer details
CustomerDetails
merchant_code
string
Optional
id
string
Optional
payment_auto_confirm
boolean
Optional
payment_mode
string
aggregator
string
Optional
address_id
string
Optional
callback_url
string
Optional
delivery_address
object
Optional
staff
object (StaffCheckout)
Optional
StaffCheckout
order_type
string
Optional
ordering_store
integer
| int32
Optional
extra_meta
object
Optional
payment_identifier
string
Optional
billing_address
object
Optional
payment_params
object
Optional
billing_address_id
string
Optional
meta
object
Optional
payment_extra_identifiers
object
Optional
iin
string
Optional
network
string
Optional
type
string
Optional
card_id
string
Optional
Response
200
Success. Returns the status of cart checkout. Refer `CartCheckoutResponseSchema` for more details.
CartCheckoutResponse
payment_confirm_url
string
Optional
app_intercept_url
string
Optional
success
boolean
Optional
callback_url
string
Optional
message
string
Optional
data
object
Optional
order_id
string
Optional
cart
object (CheckCart)
Optional
CheckCart
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
/service/application/cart/v1.0/checkout
Loading...
Response
Loading...
POST

Start cart checkout (latest)

Enhanced version of checkout process that supports multiple mode of payment(MOP).
Parameters
buyNow
boolean
Optional
This indicates the type of cart to checkout
cartType
string
Optional
The type of cart
body
object (CartCheckoutDetailV2Request)
Check the example shown below or refer `CartCheckoutDetailV2Request` for more details.
CartCheckoutDetailV2Request
custom_meta
object
Optional
customer_details
object (CustomerDetails)
Nullable
Optional
Customer details
CustomerDetails
merchant_code
string
Optional
cart_id
string
Optional
id
string
Nullable
Optional
payment_auto_confirm
boolean
Optional
payment_methods
array of object (PaymentMethod)
Array of PaymentMethod
payment_mode
string
aggregator
string
Optional
address_id
string
Optional
callback_url
string
Nullable
Optional
Default Value : null
delivery_address
object
Optional
staff
object (StaffCheckout)
Optional
StaffCheckout
order_type
string
Optional
ordering_store
integer
| int32
Nullable
Optional
extra_meta
object
Optional
payment_identifier
string
Nullable
Optional
billing_address
object
Optional
payment_params
object
Nullable
Optional
billing_address_id
string
Optional
meta
object
Optional
iin
string
Optional
network
string
Optional
type
string
Optional
card_id
string
Optional
Response
200
400
Success. Returns the status of cart checkout. Refer `CartCheckoutResponseSchema` for more details.
CartCheckoutResponse
payment_confirm_url
string
Optional
app_intercept_url
string
Optional
success
boolean
Optional
callback_url
string
Optional
message
string
Optional
data
object
Optional
order_id
string
Optional
cart
object (CheckCart)
Optional
CheckCart
Examples
Parameters
Parameters are not required.
Was this section helpful?
POST
/service/application/cart/v2.0/checkout
Loading...
Response
Loading...

Coupon

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
/service/application/cart/v1.0/coupon
# List available coupons
POST
/service/application/cart/v1.0/coupon
# Apply coupon
DEL
/service/application/cart/v1.0/coupon
# Remove coupon
GET
/service/application/cart/v1.0/bulk-price
# List bulk discounts
GET
/service/application/cart/v1.0/payment/validate/
# Validate applied coupon
GET

List available coupons

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
id
string
Optional
The unique identifier of the cart.
buyNow
boolean
Optional
This is boolean to get buy_now cart
slug
string
Optional
Product slug to fetch the available coupons
storeId
string
Optional
Store id
Response
200
Success. Returns a coupon object which has a list of all the eligible coupons. Refer `GetCouponResponse` for more details.
GetCouponResponse
page
object (PageCoupon)
Optional
PageCoupon
available_coupon_list
array of object (Coupon)
Optional
Array of Coupon
Examples
Parameters
id:
"value"
buyNow:
false
slug:
"value"
storeId:
"value"
Was this section helpful?
GET
/service/application/cart/v1.0/coupon
Loading...
Response
Loading...
POST

Apply coupon

Apply a coupon code to the customer's cart to trigger discounts on eligible items
Parameters
i
boolean
Optional
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
Optional
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
p
boolean
Optional
This is a boolean value. Select `true` for getting a payment option in response.
id
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
cartType
string
Optional
The type of cart
body
object (ApplyCouponRequest)
Pass coupon code in the request body as shown below.
ApplyCouponRequest
coupon_code
string
Coupon code to be applied
Response
201
Success. Returns coupons applied to the cart along with item details and price breakup. Refer `CartDetailResponse` for more details.
CartDetailResponse
cart_id
integer
| int32
Optional
uid
string
Optional
applied_promo_details
array of object (AppliedPromotion)
Optional
Array of AppliedPromotion
checkout_mode
string
Optional
pan_no
string
Optional
is_valid
boolean
Optional
id
string
Optional
payment_selection_lock
object (PaymentSelectionLock)
Optional
PaymentSelectionLock
delivery_promise
object (ShipmentPromise)
Optional
ShipmentPromise
comment
string
Optional
items
array of object (CartProductInfo)
Optional
Array of CartProductInfo
delivery_charge_info
string
Optional
common_config
object (CartCommonConfig)
Optional
CartCommonConfig
coupon
object (CartDetailCoupon)
Optional
CartDetailCoupon
message
string
Optional
notification
object
Optional
staff_user_id
string
Optional
success
boolean
Optional
gstin
string
Optional
restrict_checkout
boolean
Optional
last_modified
string
| date-time
Optional
breakup_values
object (CartBreakup)
Optional
CartBreakup
currency
object (CartCurrency)
Optional
CartCurrency
coupon_text
string
Optional
buy_now
boolean
Optional
pan_config
object
Optional
Examples
Parameters
i:
false
b:
false
p:
false
id:
"value"
buyNow:
false
cartType:
"value"
body:
body
Was this section helpful?
POST
/service/application/cart/v1.0/coupon
Loading...
Response
Loading...
DEL

Remove coupon

Remove an applied coupon from the customer's cart, thereby removing the associated discount from the cart total.
Parameters
id
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
Response
200
Success. Returns coupons removed from the cart along with item details and price breakup. Refer `CartDetailResponse` for more details.
CartDetailResponse
cart_id
integer
| int32
Optional
uid
string
Optional
applied_promo_details
array of object (AppliedPromotion)
Optional
Array of AppliedPromotion
checkout_mode
string
Optional
pan_no
string
Optional
is_valid
boolean
Optional
id
string
Optional
payment_selection_lock
object (PaymentSelectionLock)
Optional
PaymentSelectionLock
delivery_promise
object (ShipmentPromise)
Optional
ShipmentPromise
comment
string
Optional
items
array of object (CartProductInfo)
Optional
Array of CartProductInfo
delivery_charge_info
string
Optional
common_config
object (CartCommonConfig)
Optional
CartCommonConfig
coupon
object (CartDetailCoupon)
Optional
CartDetailCoupon
message
string
Optional
notification
object
Optional
staff_user_id
string
Optional
success
boolean
Optional
gstin
string
Optional
restrict_checkout
boolean
Optional
last_modified
string
| date-time
Optional
breakup_values
object (CartBreakup)
Optional
CartBreakup
currency
object (CartCurrency)
Optional
CartCurrency
coupon_text
string
Optional
buy_now
boolean
Optional
pan_config
object
Optional
Examples
Parameters
id:
"value"
buyNow:
false
Was this section helpful?
DEL
/service/application/cart/v1.0/coupon
Loading...
Response
Loading...
GET

List bulk discounts

Retrieve a list of offer discounts with information about quantity and seller. One offer is marked with a "best" flag, indicating it as the best offer among the list.
Parameters
itemId
integer
Optional
The Item ID of the product
articleId
string
Optional
Article Mongo ID
uid
integer
Optional
UID of the product
slug
string
Optional
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
Response
200
500
Success. Returns a data object containing the seller details and available offers (if exists) on bulk products. Refer `BulkPriceResponse` for more details.
BulkPriceResponse
data
array of object (BulkPriceOffer)
Optional
Consist of offers from multiple seller
Array of BulkPriceOffer
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
/service/application/cart/v1.0/bulk-price
Loading...
Response
Loading...
GET

Validate applied coupon

Validate the applicability of a coupon code for the selected payment mode for the existing cart. This ensures the coupon's validity before proceeding with the payment process, enhancing user experience and preventing potential errors during transactions.
Parameters
id
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
addressId
string
Optional
ID allotted to an address
paymentMode
string
Optional
Payment mode selected by the customer
paymentIdentifier
string
Optional
Identifier of payment like ICIC, PAYTM
aggregatorName
string
Optional
Payment gateway identifier
merchantCode
string
Optional
Identifier used by payment gateway for a given payment mode, e.g. NB_ICIC, PAYTM
iin
string
Optional
Debit/Credit card prefix (first 6 digit)
network
string
Optional
Credit/Debit card issuer, e.g. VISA, MASTERCARD, RUPAY
type
string
Optional
card type, e.g. Credit, Debit
cardId
string
Optional
saved card token reference id
cartType
string
Optional
type of the cart
Response
200
Success. Returns a success message and the coupon validity. Refer `PaymentCouponValidate` for more details.
PaymentCouponValidate
message
string
Optional
coupon_validity
object (CouponValidity)
Optional
CouponValidity
success
boolean
Examples
Parameters
id:
"value"
buyNow:
false
addressId:
"value"
paymentMode:
"value"
paymentIdentifier:
"value"
aggregatorName:
"value"
merchantCode:
"value"
iin:
"value"
network:
"value"
type:
"value"
cardId:
"value"
cartType:
"value"
Was this section helpful?
GET
/service/application/cart/v1.0/payment/validate/
Loading...
Response
Loading...

Customer address

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
/service/application/cart/v1.0/address
# List customer addresses
POST
/service/application/cart/v1.0/address
# Create a new address
GET
/service/application/cart/v1.0/address/{id}
# Get a address
PUT
/service/application/cart/v1.0/address/{id}
# Update a address
DEL
/service/application/cart/v1.0/address/{id}
# Delete a address
POST
/service/application/cart/v1.0/select-address
# Select a delivery address
GET

List customer addresses

Retrieve a list of all addresses saved by the customer, simplifying the checkout process by offering pre-saved address options for delivery.
Parameters
cartId
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
mobileNo
string
Optional
10-digit mobile number
checkoutMode
string
Optional
Option to checkout for self or for others
tags
string
Optional
Tag given to an address, e.g. work, home, office, shop.
isDefault
boolean
Optional
This is a boolean value. Select `true` to fetch the default address.
Response
200
Success. Returns an Address object containing a list of address saved in the account. Refer `GetAddressesResponse` for more details.
GetAddressesResponse
pii_masking
boolean
Optional
address
array of object (Address)
Optional
Array of Address
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
/service/application/cart/v1.0/address
Loading...
Response
Loading...
POST

Create a new address

Customers can add a new address to their cart to save details such as name, email, contact information, and address.
Parameters
body
object (Address)
Add address details in the request body as shown below or refer `Address` for more details.
Address
country_iso_code
string
Optional
area
string
Optional
phone
string
Optional
country_phone_code
string
Optional
checkout_mode
string
Optional
address
string
Optional
area_code_slug
string
Optional
geo_location
object (GeoLocation)
Optional
GeoLocation
id
string
Optional
_custom_json
object
Optional
city
string
Optional
sector
string
Optional
state_code
string
Optional
State code for international address
created_by_user_id
string
Optional
landmark
string
Optional
user_id
string
Optional
name
string
Optional
google_map_point
object
Optional
is_active
boolean
Optional
tags
array of string
Optional
country_code
string
Optional
address_type
string
Optional
country
string
Optional
is_default_address
boolean
Optional
area_code
string
Optional
email
string
Optional
state
string
Optional
meta
object
Optional
Response
200
Success. Returns the address ID, a flag whether the address is set as default, and a success message. Refer `SaveAddressResponse` for more details.
SaveAddressResponse
id
string
Optional
success
boolean
Optional
is_default_address
boolean
Optional
Examples
Parameters
body:
body
Was this section helpful?
POST
/service/application/cart/v1.0/address
Loading...
Response
Loading...
GET

Get a address

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
id
string
ID allotted to the selected address
cartId
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
mobileNo
string
Optional
10-digit mobile number
checkoutMode
string
Optional
Option to checkout for self or for others
tags
string
Optional
Tag given to an address, e.g. work, home, office, shop.
isDefault
boolean
Optional
This is a boolean value. Select `true` to fetch the default address.
Response
200
Success. Returns an Address object containing a list of address saved in the account. Refer `Address` for more details.
Address
country_iso_code
string
Optional
area
string
Optional
phone
string
Optional
country_phone_code
string
Optional
checkout_mode
string
Optional
address
string
Optional
area_code_slug
string
Optional
geo_location
object (GeoLocation)
Optional
GeoLocation
id
string
Optional
_custom_json
object
Optional
city
string
Optional
sector
string
Optional
state_code
string
Optional
State code for international address
created_by_user_id
string
Optional
landmark
string
Optional
user_id
string
Optional
name
string
Optional
google_map_point
object
Optional
is_active
boolean
Optional
tags
array of string
Optional
country_code
string
Optional
address_type
string
Optional
country
string
Optional
is_default_address
boolean
Optional
area_code
string
Optional
email
string
Optional
state
string
Optional
meta
object
Optional
Examples
Parameters
id:
"value"
cartId:
"value"
buyNow:
false
mobileNo:
"value"
checkoutMode:
"value"
tags:
"value"
isDefault:
false
Was this section helpful?
GET
/service/application/cart/v1.0/address/{id}
Loading...
Response
Loading...
PUT

Update a address

Customer can modify the details of a previously saved addresses.
Parameters
id
string
ID allotted to the selected address
body
object (Address)
Add address details in the request body as shown below or refer `Address` for more details.
Address
country_iso_code
string
Optional
area
string
Optional
phone
string
Optional
country_phone_code
string
Optional
checkout_mode
string
Optional
address
string
Optional
area_code_slug
string
Optional
geo_location
object (GeoLocation)
Optional
GeoLocation
id
string
Optional
_custom_json
object
Optional
city
string
Optional
sector
string
Optional
state_code
string
Optional
State code for international address
created_by_user_id
string
Optional
landmark
string
Optional
user_id
string
Optional
name
string
Optional
google_map_point
object
Optional
is_active
boolean
Optional
tags
array of string
Optional
country_code
string
Optional
address_type
string
Optional
country
string
Optional
is_default_address
boolean
Optional
area_code
string
Optional
email
string
Optional
state
string
Optional
meta
object
Optional
Response
201
Success. Returns the address ID and a message indicating a successful address updation.
UpdateAddressResponse
is_updated
boolean
Optional
id
string
Optional
success
boolean
Optional
is_default_address
boolean
Optional
Examples
Parameters
id:
"value"
body:
body
Was this section helpful?
PUT
/service/application/cart/v1.0/address/{id}
Loading...
Response
Loading...
DEL

Delete a address

Removes an existing customer address from the system.
Parameters
id
string
ID allotted to the selected address
Response
201
Returns a Status object indicating the success or failure of address deletion.
DeleteAddressResponse
id
string
Optional
is_deleted
boolean
Optional
Examples
Parameters
id:
"value"
Was this section helpful?
DEL
/service/application/cart/v1.0/address/{id}
Loading...
Response
Loading...
POST

Select a delivery address

Selects an address from the saved customer addresses and validates the availability of items in the cart. Additionally, it verifies and updates the delivery promise based on the selected address.
Parameters
cartId
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
i
boolean
Optional
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
Optional
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
body
object (SelectCartAddressRequest)
Pass address details in the request body as shown below or refer `SelectCartAddressRequest` for more details.
SelectCartAddressRequest
id
string
Optional
billing_address_id
string
Optional
cart_id
string
Optional
Response
201
400
Success. Returns a Cart object as shown below. Refer `CartDetailResponse` for more details. .
CartDetailResponse
cart_id
integer
| int32
Optional
uid
string
Optional
applied_promo_details
array of object (AppliedPromotion)
Optional
Array of AppliedPromotion
checkout_mode
string
Optional
pan_no
string
Optional
is_valid
boolean
Optional
id
string
Optional
payment_selection_lock
object (PaymentSelectionLock)
Optional
PaymentSelectionLock
delivery_promise
object (ShipmentPromise)
Optional
ShipmentPromise
comment
string
Optional
items
array of object (CartProductInfo)
Optional
Array of CartProductInfo
delivery_charge_info
string
Optional
common_config
object (CartCommonConfig)
Optional
CartCommonConfig
coupon
object (CartDetailCoupon)
Optional
CartDetailCoupon
message
string
Optional
notification
object
Optional
staff_user_id
string
Optional
success
boolean
Optional
gstin
string
Optional
restrict_checkout
boolean
Optional
last_modified
string
| date-time
Optional
breakup_values
object (CartBreakup)
Optional
CartBreakup
currency
object (CartCurrency)
Optional
CartCurrency
coupon_text
string
Optional
buy_now
boolean
Optional
pan_config
object
Optional
Examples
Parameters
cartId:
"value"
buyNow:
false
i:
false
b:
false
body:
body
Was this section helpful?
POST
/service/application/cart/v1.0/select-address
Loading...
Response
Loading...

Payment mode

Payment mode refers to the method used by customers to pay for their purchases during the checkout process. Payment modes typically include options such as credit card, debit card, digital wallets, bank transfer, cash on delivery (COD), and various online payment platforms like PayPal or Stripe. Customers select their preferred payment mode based on factors such as convenience, security, and availability. The chosen payment mode dictates how the transaction is processed and completed, ensuring a smooth and secure payment experience for the customer.

Operations
PUT
/service/application/cart/v1.0/payment
# Select payment mode
PUT

Select payment mode

Customers can select a preferred payment mode from available options during the cart checkout process to securely and efficiently complete their transaction.
Parameters
id
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
body
object (UpdateCartPaymentRequest)
Check the example shown below or refer `UpdateCartPaymentRequest` for more details.
UpdateCartPaymentRequest
id
string
Optional
payment_identifier
string
Nullable
Optional
address_id
string
Optional
merchant_code
string
Optional
aggregator_name
string
Optional
payment_mode
string
Optional
Response
200
Success. Returns a Cart object as shown below. Refer `CartDetailResponse` for more details.
CartDetailResponse
cart_id
integer
| int32
Optional
uid
string
Optional
applied_promo_details
array of object (AppliedPromotion)
Optional
Array of AppliedPromotion
checkout_mode
string
Optional
pan_no
string
Optional
is_valid
boolean
Optional
id
string
Optional
payment_selection_lock
object (PaymentSelectionLock)
Optional
PaymentSelectionLock
delivery_promise
object (ShipmentPromise)
Optional
ShipmentPromise
comment
string
Optional
items
array of object (CartProductInfo)
Optional
Array of CartProductInfo
delivery_charge_info
string
Optional
common_config
object (CartCommonConfig)
Optional
CartCommonConfig
coupon
object (CartDetailCoupon)
Optional
CartDetailCoupon
message
string
Optional
notification
object
Optional
staff_user_id
string
Optional
success
boolean
Optional
gstin
string
Optional
restrict_checkout
boolean
Optional
last_modified
string
| date-time
Optional
breakup_values
object (CartBreakup)
Optional
CartBreakup
currency
object (CartCurrency)
Optional
CartCurrency
coupon_text
string
Optional
buy_now
boolean
Optional
pan_config
object
Optional
Examples
Parameters
id:
"value"
buyNow:
false
body:
body
Was this section helpful?
PUT
/service/application/cart/v1.0/payment
Loading...
Response
Loading...

Promotion offers

Promotion offers are special incentives or discounts provided to customers to encourage purchases or enhance their shopping experience. These offers can take various forms, such as percentage discounts, fixed-price discounts, free shipping, buy-one-get-one (BOGO) deals. Ladder pricing, also known as tiered pricing, refers to a pricing strategy where the price of a product varies depending on the quantity purchased or other specified criteria. With ladder pricing, customers are incentivized to buy more by offering discounts or reduced prices for larger quantities or higher purchase volumes. For example, a retailer might offer a discounted price per unit for purchasing 10 items instead of just one.

Operations
GET
/service/application/cart/v1.0/available-promotions
# List available promotion offers
GET
/service/application/cart/v1.0/available-ladder-prices
# List ladder offers
GET

List available promotion offers

Retrieve a list of all promotional offers available for the items in the cart, including details such as offer text, unique promotion ID, and validity period.
Parameters
slug
string
Optional
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
pageSize
integer
Optional
Number of offers to be fetched to show
promotionGroup
string
Optional
Type of promotion groups
storeId
integer
Optional
Store id
cartType
string
Optional
The type of cart
Response
200
400
Success. Returns a array containing the available offers (if exists) on product via promotions. Refer `PromotionOffersResponse` for more details.
PromotionOffersResponse
available_promotions
array of object (PromotionOffer)
Optional
Array of PromotionOffer
Examples
Parameters
slug:
"value"
pageSize:
0
promotionGroup:
"value"
storeId:
0
cartType:
"value"
Was this section helpful?
GET
/service/application/cart/v1.0/available-promotions
Loading...
Response
Loading...
GET

List ladder offers

Retrieve ladder offers associated for the items in the cart. Ladder offers provide discounts or special pricing based on item quantity, allowing users to benefit from bulk purchases or promotional deals.
Parameters
slug
string
A short, human-readable, URL-friendly identifier of a product. You can get slug value from the endpoint /service/application/catalog/v1.0/products/
storeId
string
Optional
Store uid of assigned store on PDP page. If not passed default first created ladder will be returned
promotionId
string
Optional
Get ladder information of given promotion id explicitely
pageSize
integer
Optional
Number of offers to be fetched to show
Response
200
400
Success. Returns a object containing the applicable ladder price offers (if exists) on product. Refer `PromotionOffersResponse` for more details.
LadderPriceOffers
available_offers
array of object (LadderPriceOffer)
Optional
Array of LadderPriceOffer
currency
object (CurrencyInfo)
Optional
CurrencyInfo
Examples
Parameters
slug:
"value"
storeId:
"value"
promotionId:
"value"
pageSize:
0
Was this section helpful?
GET
/service/application/cart/v1.0/available-ladder-prices
Loading...
Response
Loading...

Reward Points

Reward points are incentives given to customers as part of a loyalty program or promotional campaign. Users accumulate reward points through various activities, such as making purchases, referring friends, or engaging with the platform. Reward points can be redeemed for discounts.

Operations
POST
/service/application/cart/v1.0/redeem/points/
# Use reward points
POST

Use reward points

Users can redeem their accumulated reward points and apply them to the items in their cart, thereby availing discounts on their current purchases.
Parameters
id
string
Optional
The unique identifier of the cart
i
boolean
Optional
This is a boolean value. Select `true` to retrieve all the items added in the cart.
b
boolean
Optional
This is a boolean value. Select `true` to retrieve the price breakup of cart items.
buyNow
boolean
Optional
This is boolean to get buy_now cart
body
object (RewardPointRequest)
Check the example shown below or refer `RewardPointRequestSchema` for more details.
RewardPointRequest
points
boolean
Response
200
Success. Returns a Cart object. Check the example shown below or refer `CartDetailResponse` for more details.
CartDetailResponse
cart_id
integer
| int32
Optional
uid
string
Optional
applied_promo_details
array of object (AppliedPromotion)
Optional
Array of AppliedPromotion
checkout_mode
string
Optional
pan_no
string
Optional
is_valid
boolean
Optional
id
string
Optional
payment_selection_lock
object (PaymentSelectionLock)
Optional
PaymentSelectionLock
delivery_promise
object (ShipmentPromise)
Optional
ShipmentPromise
comment
string
Optional
items
array of object (CartProductInfo)
Optional
Array of CartProductInfo
delivery_charge_info
string
Optional
common_config
object (CartCommonConfig)
Optional
CartCommonConfig
coupon
object (CartDetailCoupon)
Optional
CartDetailCoupon
message
string
Optional
notification
object
Optional
staff_user_id
string
Optional
success
boolean
Optional
gstin
string
Optional
restrict_checkout
boolean
Optional
last_modified
string
| date-time
Optional
breakup_values
object (CartBreakup)
Optional
CartBreakup
currency
object (CartCurrency)
Optional
CartCurrency
coupon_text
string
Optional
buy_now
boolean
Optional
pan_config
object
Optional
Examples
Parameters
id:
"value"
i:
false
b:
false
buyNow:
false
body:
body
Was this section helpful?
POST
/service/application/cart/v1.0/redeem/points/
Loading...
Response
Loading...

Shipment

Shipment refers to the process of delivering purchased items from the seller's location to the customer’s designated address. Shipment details includes seller information, estimated delivery dates, item quantity, order type (Home Delivery or Digital) and other shipment meta information. Additionally, it provides details about the items included in the shipment.

Operations
GET
/service/application/cart/v1.0/shipment
# List shipments
GET

List shipments

Retrieve shipment details for the items in a cart, specific to the selected address. Shipment details include delivery promises, seller information, item details, and other relevant information.
Parameters
p
boolean
Optional
This is a boolean value. Select `true` for getting a payment option in response.
id
string
Optional
The unique identifier of the cart
buyNow
boolean
Optional
This is boolean to get buy_now cart
addressId
string
Optional
ID allotted to the selected address
areaCode
string
Optional
The PIN Code of the destination address, e.g. 400059
orderType
string
Optional
The order type of shipment HomeDelivery - If the customer wants the order home-delivered PickAtStore - If the customer wants the handover of an order at the store itself. Digital - If the customer wants to buy digital voucher ( for jiogames )
Response
200
500
Success. Returns delivery promise along with shipment details and price breakup. Refer `CartShipmentsResponse` for more details.
CartShipmentsResponse
delivery_charge_info
string
Optional
checkout_mode
string
Optional
message
string
Optional
gstin
string
Optional
restrict_checkout
boolean
Optional
last_modified
string
| date-time
Optional
cart_id
integer
| int32
Optional
is_valid
boolean
Optional
breakup_values
object (CartBreakup)
Optional
CartBreakup
currency
object (CartCurrency)
Optional
CartCurrency
id
string
Optional
shipments
array of object (ShipmentResponse)
Optional
Array of ShipmentResponse
payment_selection_lock
object (PaymentSelectionLock)
Optional
PaymentSelectionLock
coupon_text
string
Optional
delivery_promise
object (ShipmentPromise)
Optional
ShipmentPromise
error
boolean
Optional
comment
string
Optional
buy_now
boolean
Optional
uid
string
Optional
Examples
Parameters
Parameters are not required.
Was this section helpful?
GET
/service/application/cart/v1.0/shipment
Loading...
Response
Loading...