v1
latestOpenAPI 3.0.02026-07-26318168886.7 KBCarts
Prepare Cart
Prepare Cart
post/carts/{cart_id}/prepare
Path parameters
cart_idstring required
Cart identifier
Headers
localestring
Language code for translation or localization. Supported values: zh-hant (Traditional Chinese), zh-cn (Simplified Chinese) and en (English).
Response
OK
Example response
{
"data": {
"owner_id": "30b720ab8f86a0ebb56a324fe6d4992a",
"coupon_codes": [
"coupon_code_freeshipping"
],
"user_member_point_balance_except_redeem_gift": 100,
"available_payments": [
{
"fee_multiplier": 0.1,
"fee_percent": 10,
"instructions_translations": {
"zh-hant": "付款指示說明"
},
"dropdown_content": "信用卡部分禁止提示",
"name_translations": {
"zh-cn": "银行转账/ATM",
"zh-hant": "銀行轉帳／ATM",
"en": "Bank Transfer"
},
"show_description_on_checkout": true,
"activity_content": "付款活動詳情文案",
"instruction_media": [
{
"blurhash": "UTHn?6V?xuR*~qa{Rja}KQR+RQo09bRlRPt6",
"images": {
"original": {
"url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/66fd1b315fa849006183c287/original.jpeg?1727863601",
"width": 800,
"height": 533
}
},
"id": "66fd1b315fa849006183c287"
}
],
"id": "650c00c807054b004bedba28",
"type": "bank_transfer",
"config_data": {
"installments": [
"24"
],
"whitelist_validation": {
"type": "card_scheme",
"card_scheme_list": [
"visa"
]
},
"shopline_payment_payment": "credit",
"shopline_payment_gateway": "adyen"
},
"instruction_media_ids": [
"63b7ebc29d779f003970bf0f"
]
}
],
"postcode": "90210",
"referral_code": "ref_123",
"user_credit_balance": 50,
"discounted_subtotal": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"custom_discount": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"deliveries": [
{
"errors": [
{
"code": "DO_NOT_REACH_PAYMENT_CHECKOUT_CONDITION",
"payload": {
"payment_id": "650c00c807054b004bedba28",
"delivery_option_id": "6822ed61ed63e5005764f973"
}
}
],
"reminders": [
{
"code": "DEFER_DELIVERY_FEE"
}
],
"delivery_data": {
"sfexpress_type": "centre",
"pakpobox_type": "smart_locker",
"location_code": "852TD",
"district_translations": {
"zh-hant": "中西區",
"en": "Central and Western"
},
"target_channel_id": "65a0fecdd910c1008f83b011",
"store_address_detail": {
"level_3": "源遠路",
"level_1": "基隆市",
"level_2": "暖暖區"
},
"name_translations": {
"en": "Unit 01 on the Ground Floor of Lung Fung Group Centre, No. 23 Yip Cheong Street, Fanling, North District, New Territories, Hong Kong^852A^",
"zh-hant": "香港新界北區粉嶺業暢街23號龍豐集團中心地下G01號舖^852A^"
},
"location_name": "實體店"
},
"country": "TW",
"delivery_address": {
"country": "台灣",
"postcode": "10560",
"recipient_phone": "0912123456",
"country_code": "TW",
"address_1": "光復北路11巷44號14樓",
"address_2": "松山區",
"city": "台北",
"recipient_name": "收件人",
"recipient_phone_country_code": "886"
},
"delivery_option_id": "66c4460f1aaa343261b52ff8",
"cart_tag_id": "66b8e0000000000000000000",
"payment_id": "66502b5041dfca0091dd91a8"
}
],
"owner_type": "Guest",
"shop_session_id": "8317974691595493",
"region_code": "CA",
"discount": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"cart_addon_items_total": {
"currency_iso": "TWD",
"label": "NT$20",
"dollars": 20,
"cents": 20,
"currency_symbol": "NT$"
},
"delivery_fee": {
"currency_iso": "TWD",
"label": "NT$0",
"currency_symbol": "NT$"
},
"affiliate_data": [
{
"affiliate_name": "line",
"utm_source": "lineshopping",
"utm_medium": "cpc"
}
],
"allowed_payment_cod_types": [
"NCOD"
],
"payment_cod_type": "NCOD",
"max_custom_discount": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"items": [
{
"type": "product",
"addon_items": [
{
"product_id": "6724494f304af900606fdee1",
"triggering_item_id": "ab1b117c1422484590f40b2b2538de6a",
"cart_tag_id": "66b8e0000000000000000000",
"reminders": [
{
"code": "ADDON_PURCHASE_LIMIT_REACHED"
}
],
"quantity": 1,
"total": {
"cents": 50,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$50",
"dollars": 50
},
"product": {
"field_titles": [
{
"key": "color",
"label": "顏色",
"name_translations": {
"en": "Color",
"ja": "カーラー",
"ms": "warna",
"th": "สี",
"vi": "Màu",
"zh-cn": "颜色",
"zh-hant": "顏色"
}
}
],
"quantity": 1,
"max_order_quantity": 3,
"id": "6724494f304af900606fdee1",
"title_translations": {
"zh-hant": "主商品加購品"
},
"cart_tag_id": "66b8e0000000000000000000",
"child_products": [
{
"child_variations": [
{
"preorder_limit": -1,
"id": "67735de55597ef003c47b612",
"key": "67735de4643750001d543683",
"quantity": 3
}
],
"id": "6757c3a152d82d003a66c795",
"quantity": 2,
"preorder_limit": 1,
"title_translations": {
"zh-hant": "商品"
}
}
],
"preorder_limit": 1,
"total_orderable_quantity": 1,
"flash_price_sets": [
{
"price_set": {
"price": {
"cents": 900,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$900",
"dollars": 900
},
"price_sale": {
"cents": 100,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$100",
"dollars": 100
}
}
}
],
"cover_media": {
"id": "6831384aa0138600387ffbe2",
"images": {
"original": {
"url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/6831384aa0138600387ffbe2/original.png?1748056137",
"width": 1024,
"height": 1024
}
}
}
},
"variation": {
"max_order_quantity": 3,
"quantity": 2,
"preorder_limit": 1,
"media": [
{
"id": "6831384aa0138600387ffbe2",
"images": {
"original": {
"width": 1024,
"height": 1024,
"url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/6831384aa0138600387ffbe2/original.png?1748056137"
}
}
}
],
"key": "67735de4643750001d543683",
"id": "6200c94b0c62ff00994704cb"
},
"errors": [
{
"code": "PRODUCT_LOW_STOCK",
"payload": {
"quantity": 3,
"limit": 1
}
}
],
"id": "7d2f708e32a94d5dabb02c55fa59767d",
"item_data": {
"name": "Item name",
"selected_child_products": [
{
"child_product_id": "6200c94b2d53210039bba565",
"child_variation_id": "6200c94b0c62ff00994704cb",
"quantity": 1
}
]
},
"type": "addon_product"
}
],
"total_point": 10,
"id": "9d8865eec7324309ba9d86d443d90a93",
"quantity": 5,
"variation": {
"media": {
"id": "677367a13b13df0038304174",
"images": {
"original": {
"width": 274,
"height": 184,
"url": "https://img-shoplineapp-com.s3.amazonaws.com/media/image_clips/677367a13b13df0038304174/original.jpeg?1735616417"
}
}
},
"id": "67735de4643750001d543683",
"quantity": 1,
"preorder_limit": 1,
"max_order_quantity": 1,
"key": "67735de4643750001d543683"
},
"cart_tag_id": "643fbf59c9105d5e8a87b43d",
"variation_id": "67ff4da9ddc093001cf1290e",
"applied_promotion": {
"discountable_quantity": 2,
"id": "68303cd6469843005fe38db3",
"cart_tag_id": "643fbf59c9105d5e8a87b43d",
"condition": {
"whitelisted_product_ids": [
"6825a6ac22fc5e00617cf0dc"
],
"min_item_count": 3
},
"whitelisted_membership_tier_ids": [
"6271126deb588d0049925ddf"
],
"required_membership": true,
"membership_tier_id": "5e844fb7b6c29b000f00f9c6",
"discount_type": "gift",
"discount_percentage": 1,
"coupon_item": {
"coupon_code": "coupon200"
},
"is_membership_tier_promotion": true
},
"product": {
"preorder_limit": 1,
"title_translations": {
"en": "Apple",
"zh-hant": "蘋果"
},
"max_order_quantity": 3,
"total_orderable_quantity": 1,
"id": "6724494f304af900606fdee1",
"field_titles": [
{
"key": "color",
"label": "顏色",
"name_translations": {
"zh-hant": "顏色",
"en": "Color"
}
}
],
"flash_price_sets": [
{
"start_at": "2025-05-24T03:00:00Z",
"end_at": "2025-05-31T06:30:00Z",
"price_set": {
"price_sale": {
"cents": 100,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$100",
"dollars": 100
},
"price": {
"label": "NT$900",
"dollars": 900,
"cents": 900,
"currency_symbol": "NT$",
"currency_iso": "TWD"
}
}
}
],
"quantity": 6,
"cover_media": {
"id": "6831384aa0138600387ffbe2"
},
"child_products": [
{
"quantity": 2,
"preorder_limit": 1,
"child_variations": [
{
"quantity": 3,
"preorder_limit": -1,
"id": "67735de55597ef003c47b612",
"key": "67735de4643750001d543683"
}
],
"id": "6757c3a152d82d003a66c795"
}
]
},
"product_id": "6724494f304af900606fdee1",
"reminders": [
{
"code": "QUANTITY_OF_LEFT_ITEM_STOCK",
"payload": {
"preorder_quantity": 1,
"stock_quantity": 2,
"quantity": 8
}
}
],
"errors": [
{
"code": "CAN_NOT_PURCHASE",
"payload": {
"limit": 1,
"quantity": 3
}
}
]
}
],
"reminders": [
{
"code": "DEFER_DELIVERY_FEE",
"payload": {
"message": "此訂單滿 NT$1,000 將能折抵購物金"
}
}
],
"available_countries": [
"TW"
],
"member_point": {
"redeemed_points": 5,
"earned_points": 10
},
"applied_member_point": 100,
"applied_user_credits": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"delivery_tax_fee": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"total_tax_fee": {
"currency_iso": "TWD",
"label": "NT$0",
"currency_symbol": "NT$"
},
"applied_promotions": [
{
"discount_type": "amount",
"extended_promotion_id": "6597a295d3ad7c005b5d594c",
"_id": "66e7e5524f05230061567e5c",
"coupon_item": {
"reward_point": 100,
"coupon_code": "coupon200",
"discounted_amount": {
"cents": 200,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$200",
"dollars": 200
},
"reward_credit": {
"cents": 20,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$20",
"dollars": 20
}
},
"discount_amount": {
"cents": 200,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$200",
"dollars": 200
},
"is_membership_tier_promotion": true,
"membership_tier_id": "6271126deb588d0049925ddf",
"condition": {
"min_item_count": 3,
"whitelisted_product_ids": [
"6825a6ac22fc5e00617cf0dc"
],
"min_price": {
"cents": 2000,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$2000",
"dollars": 2000
}
},
"discount_percentage": 1,
"discounted_price": {
"cents": 10,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$10",
"dollars": 10
},
"requires_membership": true,
"cart_tag_id": "66b8e0000000000000000000",
"discount_on": "order",
"title_translations": {
"en": "Member limited",
"zh-hant": "會員限定優惠"
},
"summary_translations": {
"label": {
"zh-hant": "已達優惠",
"en": "Discount"
}
},
"whitelisted_membership_tier_ids": [
"6271126deb588d0049925ddf"
]
}
],
"country": "TW",
"total": {
"cents": 400,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$400",
"dollars": 400
},
"applied_member_point_redeem_to_cash": {
"label": "NT$0",
"currency_symbol": "NT$",
"currency_iso": "TWD"
},
"payment_fee": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"applied_tax_info": {
"sales": {
"name": "消費稅-基本",
"min": 0.05,
"max": 0.05,
"country_code": "TW",
"flag": "🇹🇼"
},
"delivery": {
"flag": "🇹🇼",
"name": "運費稅-基本",
"min": 0.05,
"max": 0.05,
"country_code": "TW"
}
},
"available_delivery_options": [
{
"cart_tag_id": "643fbf59c9105d5e8a87b43d",
"delivery_options": [
{
"id": "66c4460f1aaa343261b52ff8",
"name_translations": {
"zh-hant": "7-11 取貨付款 (C2C)"
}
}
]
}
],
"sales_tax_fee": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$0"
},
"untriggered_promotion_items": [
{
"cart_tag_id": "643fbf59c9105d5e8a87b43d",
"seo_enabled": true,
"discount_type": "amount",
"discount_percentage": 1,
"discounted_price": {
"cents": 10,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$10",
"dollars": 10
},
"whitelisted_membership_tier_ids": [
"6271126deb588d0049925ddf"
],
"id": "67b69dcb559ad4005e8e114d",
"discount_on": "order",
"summary_translations": {
"label": {
"zh-cn": "再买 NT$300",
"zh-hant": "再買 NT$300",
"en": "Buy NT$300 more to get the offer"
},
"discount_summary": {
"zh-cn": "5月14日满额优惠",
"zh-hant": "5月14日滿額優惠"
}
},
"condition_scope": "discounted_subtotal",
"required_membership": true,
"membership_tier_id": "5e844fb7b6c29b000f00f9c6",
"discount_amount": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$200",
"dollars": 200,
"cents": 200
},
"condition_gaps": [
{
"cart_item_ids": [
"393fe83b1c1842e58428cf65cb9bb450"
],
"discountable_ids": [
"67ff4da91f4f28005dcdc7ad"
],
"selected_value": 200,
"gap_type": "amount"
}
],
"cart_tag_translations": {
"en": "Cool",
"zh-hant": "冷藏"
}
}
],
"custom_discount_items": [
{
"ref_id": "3a56327b-bff7-4c59-9fca-b61ac62e4d59",
"cart_tag_id": "66b8e0000000000000000000",
"item_data": {
"name": "自訂折扣"
},
"id": "5b594be9a7b18100050001ed",
"type": "custom_discount"
}
],
"errors": [
{
"code": "CART_FULFILLMENT_ERROR",
"payload": {
"payment_id": "650c00c807054b004bedba28",
"delivery_option_id": "6822ed61ed63e5005764f973"
}
}
],
"id": "298f1d18e7914500b9c6328c4720d38e",
"auto_reward_credit": {
"triggered": true,
"calculate_credit_value": "NT$11"
},
"subtotal": {
"cents": 200,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$200",
"dollars": 200
},
"inclusive_tax_info": {
"tax_name": "消費稅",
"fee": {
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$15",
"dollars": 15,
"cents": 15
},
"type": "inclusive",
"tax_region_id": "5e548e14e3880918ef272e8c",
"rate": 0.05,
"country_code": "TW"
}
}
}