如何通过Shopify Storefront API checkoutCreate提交自定义商品信息（无需VariantId）

云上老周

2026-7-15

问题翻译

我们有一个负责管理库存与产品的下游应用，希望使用Shopify的购物车及结账功能（包括第三方应用集成、折扣码/优惠券使用、弃购车报告以及安全机制），但不想在Shopify平台上管理库存或存储产品信息。目前使用Storefront API的checkoutCreate接口时，商品行要求传入variantId，请问是否可以不依赖Shopify内置的Product模块，直接提交商品名称与价格？我们期望实现类似以下的请求：

mutation checkoutCreate($input: CheckoutCreateInput!) {
  checkoutCreate(input: $input) {
    checkout {
      id,
      webUrl
    }
    checkoutUserErrors {
        message
    }
    queueToken
  }
}

variables:

{
  "input": {
    "allowPartialAddresses": true,
    "buyerIdentity": {
      "countryCode": "US"
    },
    "email": "name@domain.com",
    "lineItems": [
      {
        "customAttributes": [
          {
            "key": "Title",
            "value": "Hello"
          }
        ],
        "title": "Title",
        "price": "100",
        "quantity": 1
      }
    ]
  }
}

回答

不行，Shopify的Storefront API checkoutCreate接口必须通过variantId关联Shopify平台内的产品变体，无法直接提交自定义的商品名称和价格来创建购物车条目。

原因在于Shopify的结账系统高度依赖其内置的Product/Variant模型：

所有结账流程中的商品行都需要绑定到已存在的Shopify产品变体，这是平台验证价格、库存（即使你自行管理库存，Shopify仍需要变体作为功能载体）、折扣规则等的基础。
第三方应用、折扣码、优惠券等功能的触发逻辑，都是基于Shopify内的产品属性匹配的，无关联变体的自定义条目无法触发这些规则。
弃购车报告等数据统计功能，也需要关联Shopify的产品实体才能生成有效数据。

如果不想在Shopify上管理库存，可采取以下折中方案：

在Shopify后台创建虚拟产品变体：设置库存为无限（或极大值），价格设为默认值，后续通过Storefront API的checkoutLineItemsUpdate接口动态调整价格，同时用customAttributes传递下游系统的商品名称及其他信息。
使用Shopify的Draft Orders API：虽更偏向后台操作，但可创建包含自定义商品的订单，不过无法直接复用前端购物车体验。

注意：即使使用虚拟变体，也要确保变体的基本信息（如价格、税类）与下游系统逻辑兼容，避免结账时出现价格不匹配或税计算错误的问题。

内容的提问来源于stack exchange，提问作者Craig P