Android应用调用WooCommerce REST API创建订单优惠券不生效问题

嘿，我之前对接WooCommerce API时也踩过一模一样的坑——能正常创建订单、能获取优惠券信息，可就是折扣死活不生效，订单直接按原价生成。咱们从几个最常见的排查方向一步步来解决：

1. 先确认API请求的优惠券参数格式是否正确 #

这是最容易踩的坑！WooCommerce API要求优惠券必须放在coupon_lines数组里，而不是单独传一个coupon_code之类的字段。正确的请求体结构应该是这样的：

{
  "status": "pending",
  "payment_method": "cod",
  "billing": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john@example.com"
  },
  "line_items": [
    {
      "product_id": 123,
      "quantity": 1
    }
  ],
  "coupon_lines": [
    {
      "code": "YOUR_DISCOUNT_CODE"
    }
  ]
}

你得仔细核对自己的请求，是不是正确嵌套了coupon_lines数组，有没有把优惠券代码写错，或者传成了其他不符合要求的字段名。

2. 排查优惠券本身的设置问题 #

很多时候不是API的锅，是优惠券的适用条件没满足：

• 先去WooCommerce后台确认优惠券是启用状态（是“发布”状态，不是草稿或已过期）；
• 检查优惠券的使用门槛：比如是不是要求订单金额达到某个数值，而你创建的订单金额没达标？或者是不是仅限特定商品/分类，你订单里的商品不在范围内？
• 查看优惠券的使用限制：是不是已经用完了使用次数？或者仅限登录用户使用，但你创建订单时没有关联用户ID（customer_id字段）？
• 还有叠加规则：如果商品本身已经有促销价，而优惠券设置了“不允许与其他折扣叠加”，那折扣也不会生效。

3. 测试后台手动创建订单是否生效 #

先排除优惠券本身的问题：去WooCommerce后台手动创建一个和API请求完全一致的订单，添加同一个优惠券，看看折扣能不能正常显示。如果后台也不生效，那肯定是优惠券设置的问题；如果后台生效，那就是API请求的参数有遗漏或错误。

4. 检查WooCommerce版本兼容性 #

从你提供的订单响应里看到WooCommerce版本是3.2.6，这个版本比较老旧了，可能和你使用的REST API版本（比如v3）存在兼容性问题。建议升级到较新的稳定版（比如最新的7.x系列），同时确保API请求使用的是对应版本的端点（比如/wp-json/wc/v3/orders）。

最后提个容易忽略的小细节 #

如果你的优惠券是针对特定用户的，那创建订单时必须在请求里传入customer_id，并且这个用户ID要和优惠券设置的允许用户匹配，否则折扣也不会生效。

内容的提问来源于stack exchange，提问作者James Piterson