创建购物车 - 宠物商店

创建购物车。虽然是可选的，但指定购物车的地区和销售渠道可能会影响购物车的定价和
可以分别添加到购物车中的产品。因此，请确保尽早设置并在必要时进行更改，例如当客户更改其地区时。

如果客户已登录，请确保在购物车的详细信息中传递其ID或电子邮件，以便将购物车连接到客户。

curl --location --request POST 'https://apifoxmock.com/m1/4997831-4656773-default/store/carts' \ --header 'Content-Type: application/json' \ --data-raw '{ "region_id": "string", "sales_channel_id": "string", "country_code": "string", "context": { "ip": "::1", "user_agent": "Chrome" }, "items": [ { "variant_id": "string", "quantity": 0 } ] }'

请求参数

Body 参数application/json

要创建的购物车的详细信息。

region_id

string

可选

要在其中创建购物车的地区的 ID。设置购物车的地区会影响购物车中商品的定价以及使用的货币。如果未提供此参数，则默认使用商店中的第一个地区。

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. If you add a publishable API key in the header of this request, you don't specify a sales channel ID, and the publishable API key is associated with one sales channel, that sales channel will be attached to the cart. If no sales channel is passed and no publishable API key header is passed or the publishable API key isn't associated with any sales channel, the cart will not be associated with any sales channel.

country_code

string

可选

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

context

object

可选

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

示例值:

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

items

array [object {2}]

可选

用于生成订单项的产品变体数组。

variant_id

string

产品变体的 ID。

必需

quantity

integer

必需

要添加到购物车中的数量。

示例

返回响应

🟢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服务器错误