更新购物车 - 宠物商店

更新购物车的详细信息。如果购物车具有支付会话并且未更改地区，则支付会话将更新。购物车的总计也将重新计算。

curl --location --request POST 'https://apifoxmock.com/m1/4997831-4656773-default/store/carts/' \ --header 'Content-Type: application/json' \ --data-raw '{ "region_id": "string", "email": "user@example.com", "sales_channel_id": "string", "customer_id": "string", "country_code": "string", "context": { "ip": "::1", "user_agent": "Chrome" }, "gift_cards": [ { "code": "string" } ], "discounts": [ { "code": "string" } ], "billing_address": { "first_name": "Arno", "last_name": "Willms", "phone": 16128234334802, "company": "string", "address_1": "14433 Kemmer Court", "address_2": "Suite 369", "city": "South Geoffreyview", "province": "Kentucky", "postal_code": 72093, "country_code": "st", "metadata": { "car": "white" } }, "shipping_address": { "first_name": "Arno", "last_name": "Willms", "phone": 16128234334802, "company": "string", "address_1": "14433 Kemmer Court", "address_2": "Suite 369", "city": "South Geoffreyview", "province": "Kentucky", "postal_code": 72093, "country_code": "st", "metadata": { "car": "white" } } }'

请求参数

Path 参数

string

购物车的ID。

必需

Body 参数application/json

region_id

string

可选

要在其中创建购物车的地区的 ID。设置购物车的地区会影响购物车中商品的定价以及使用的货币。

string <email>

可选

要在购物车上使用的电子邮件。

sales_channel_id

string

可选

The ID of the Sales channel to create the Cart in. The cart's sales channel affects which products can be added to the cart. If a product does not exist in the cart's sales channel, it cannot be added to the cart. If you add a publishable API key in the header of this request and specify a sales channel ID, the specified sales channel must be within the scope of the publishable API key's resources.

customer_id

string

可选

要与购物车关联的客户的 ID。

country_code

string

可选

要在其中创建购物车的 2 个字符的 ISO 国家/地区代码。设置此参数将设置送货地址的国家/地区代码。

context

object

可选

一个对象，用于为购物车提供上下文。context 字段会自动填充 ip 和 user_agent

示例值:

{"ip":"::1","user_agent":"Chrome"}

gift_cards

array [object {1}]

可选

要添加到购物车的礼品卡代码数组。

code

string

礼品卡的代码。

必需

discounts

array [object {1}]

可选

要添加到购物车的折扣代码数组。

code

string

折扣的代码。

必需

billing_address

可选

用于账单目的的地址。

Any of

AddressPayload

string

创建/更新地址时使用的地址字段。

first_name

string

名

可选

示例值:

Arno

last_name

string

姓

可选

示例值:

Willms

phone

string

电话号码

可选

示例值:

16128234334802

company

string

公司

可选

address_1

string

地址行 1

可选

示例值:

14433 Kemmer Court

address_2

string

地址行 2

可选

示例值:

Suite 369

city

string

城市

可选

示例值:

South Geoffreyview

province

string

省

可选

示例值:

Kentucky

postal_code

string

邮政编码

可选

示例值:

72093

country_code

string

可选

国家/地区的 2 个字符的 ISO 代码（小写）

示例值:

metadata

object

可选

包含其他详细信息的可选键值映射

示例值:

{"car":"white"}

shipping_address

可选

用于送货目的的地址。

Any of

AddressPayload

string

创建/更新地址时使用的地址字段。

first_name

string

名

可选

示例值:

Arno

last_name

string

姓

可选

示例值:

Willms

phone

string

电话号码

可选

示例值:

16128234334802

company

string

公司

可选

address_1

string

地址行 1

可选

示例值:

14433 Kemmer Court

address_2

string

地址行 2

可选

示例值:

Suite 369

city

string

城市

可选

示例值:

South Geoffreyview

province

string

省

可选

示例值:

Kentucky

postal_code

string

邮政编码

可选

示例值:

72093

country_code

string

可选

国家/地区的 2 个字符的 ISO 代码（小写）

示例值:

metadata

object

可选

包含其他详细信息的可选键值映射

示例值:

{"car":"white"}

示例

返回响应

🟢200正常

application/json

Body

购物车的详细信息。

cart

object (Cart)

必需

购物车代表一个虚拟购物袋。它可用于完成订单、交换或索赔。

string

购物车的 ID

必需

示例值:

cart_01G8ZH853Y6TFXWPG5EYE81X63

string <email> | null

必需

与购物车关联的电子邮件

billing_address_id

string | null

账单地址的 ID

必需

示例值:

addr_01G8ZH853YPY9B94857DY91YGW

shipping_address_id

string | null

送货地址的 ID

必需

示例值:

addr_01G8ZH853YPY9B94857DY91YGW

region_id

string

地区的 ID

必需

示例值:

reg_01G1G5V26T9H8Y0M4JNE3YGA4G

customer_id

string | null

客户的 ID

必需

示例值:

cus_01G2SG30J8C85S4A5CHM2S1NS2

customer

object | null

可选

购物车所属客户的详细信息。

payment_session

object | null

必需

购物车中所选支付会话的详细信息。

payment_id

string | null

必需

付款的 ID（如果可用）

示例值:

pay_01G8ZCC5W42ZNY842124G7P5R9

payment

object | null

可选

与购物车关联的付款的详细信息。

completed_at

string <date-time> | null

必需

购物车完成的日期和时区。

payment_authorized_at

string <date-time> | null

必需

付款获得授权的日期和时区。

sales_channel_id

string | null

可选

购物车关联的销售渠道 ID。

示例值:

null

created_at

string <date-time>

必需

资源创建时间（含时区）。

updated_at

string <date-time>

必需

资源更新时间（含时区）。

deleted_at

string <date-time> | null

必需

资源删除时间（含时区）。

shipping_total

integer

运费总额

可选

示例值:

1000

discount_total

integer

可选

折扣总额（四舍五入）

示例值:

800

raw_discount_total

integer

折扣总额

可选

示例值:

800

item_tax_total

integer

含税商品总额

可选

示例值:

8000

shipping_tax_total

integer

含税运费总额

可选

示例值:

1000

tax_total

integer

税总额

可选

示例值:

refunded_total

integer

可选

如果与此购物车关联的订单已退回，则为退款总额。

示例值:

total

integer

购物车的总金额

可选

示例值:

8200

subtotal

integer

购物车小计

可选

示例值:

8000

refundable_amount

integer

可退款金额

可选

示例值:

8200

gift_card_total

integer

礼品卡总额

可选

示例值:

gift_card_tax_total

integer

含税礼品卡总额

可选

示例值:

payment_sessions

array [object]

可选

在购物车上创建的所有支付会话的详细信息。

type

enum<string>

购物车的类型。

必需

枚举值:

defaultswapdraft_orderpayment_linkclaim

默认值:

default

idempotency_key

string | null

必需

随机生成的密钥，用于在发生故障时继续完成购物车。

context

object | null

必需

购物车的上下文，可以包含 IP 或用户代理等信息。

示例值:

{"ip":"::1","user_agent":"PostmanRuntime/7.29.2"}

metadata

object | null

必需

包含其他详细信息的可选键值映射

示例值:

{"car":"white"}

billing_address

object (Address)

可选

地址在 Medusa 后端中的其他模式和对象类型中使用。例如，客户的账单地址和送货地址都使用地址实体。

sales_channel

object (Sales Channel)

可选

销售渠道是企业为客户提供产品购买方式的方法。例如，网上商店可以是一个销售渠道，移动应用程序可以是另一个销售渠道。

shipping_address

object (Address)

可选

地址在 Medusa 后端中的其他模式和对象类型中使用。例如，客户的账单地址和送货地址都使用地址实体。

shipping_methods

array[object (Shipping Method) {20}]

可选

添加到购物车的送货方式的详细信息。

region

object (Region)

可选

地区包含特定于地理位置的设置，包括货币、税率以及配送和支付提供程序。一个地区可以包含多个国家，以适应跨国界的常见购物设置。

gift_cards

array[object (Gift Card) {15}]

可选

应用于购物车的所有礼品卡的详细信息数组。

discounts

array[object (Discount) {18}]

可选

应用于购物车的所有折扣的详细信息数组。

items

array[object (Line Item) {42}]

可选

添加到购物车的订单项。

🟠400客户端错误或多个错误

🟠404未找到错误

🟠409无效状态错误

🟠422无效请求错误

🔴500服务器错误