使用BigCommerce API在Postman创建订单遇422错误求助

核心问题分析 #

返回422错误提示账单信息不全，结合BigCommerce Orders API的必填规则，你的请求存在两处关键问题：

1. 账单地址缺少必填字段且格式不符合要求 #

• 缺少phone字段：BigCommerce要求账单地址必须包含联系电话，这是电商API的通用必填项，你的请求中未提供。
• state字段格式错误：当country_iso2为US时，state需要填写ISO 3166-2标准的州缩写（如TX对应Texas），而非全称。

2. Products数组参数不符合API要求 #

创建订单时，products数组不能仅通过name匹配产品，必须传递product_id（产品在BigCommerce后台的ID），API才能正确识别对应的商品信息。仅传name会导致无法关联有效库存/产品数据，间接触发订单完整性校验失败。

修正后的请求示例 #

{
  "billing_address": {
    "first_name": "Pushkar",
    "last_name": "Dutta",
    "street_1": "527 Abraham Tunnel",
    "city": "Austin",
    "state": "TX",
    "zip": "78751",
    "country": "United States",
    "country_iso2": "US",
    "email": "pushkar.d@ignitiv.com",
    "phone": "512-123-4567"
  },
  "products": [
    {
      "product_id": 123, // 替换为后台实际的产品ID
      "quantity": 1
    }
  ]
}

额外验证点 #

• 确认checkout_id已正确关联到现有有效购物车
• 若店铺配置了税费规则，可省略price_inc_tax/price_ex_tax字段，API会自动计算对应金额

内容的提问来源于stack exchange，提问作者Pushkar Dutta