创建商品券

更新时间:2025.11.07

服务商可以通过该接口为品牌创建商品券和批次(或批次组)。微信支付创建成功后,会返回此次创建的商品券、批次(或批次组)。品牌方可在【经营平台】上配置【活动】对商品券进行投放。

前置条件:服务商已【设置商品券事件通知地址

频率限制:20/s

接口说明

支持商户:【普通服务商】

请求方式:【POST】/v3/marketing/partner/product-coupon/product-coupons

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


body  包体参数

 out_request_no  必填   string(40)

【创建请求单号】 品牌创建商品券的请求流水号,品牌侧需保持唯一性,可使用 数字、大小写字母、下划线_、短横线- 组成,长度在6-40个字符之间


 scope  必填   string

【优惠范围】 商品券的优惠范围

可选取值

  • ALL:  全场券,此时券类型 type 仅可配置为 NORMAL 或 DISCOUNT

  • SINGLE:  单品券,此时券类型 type 配置不受限制,即可配置为 NORMALDISCOUNT 或 EXCHANGE


 type  必填   string

【商品券类型】 商品券的优惠类型

可选取值

  • NORMAL:  满减券

  • DISCOUNT:  折扣券

  • EXCHANGE:  兑换券,仅在 scope 为 SINGLE 时可配置


 usage_mode  必填   string

【使用模式】 商品券使用模式

可选取值

  • SINGLE:  单券,即用户只能使用一次,使用后券失效

  • PROGRESSIVE_BUNDLE:  多次优惠,由一组批次组成,每阶梯次序对应一个批次。用户按顺序使用,每次核销后发放下一张券,直到用完为止


 single_usage_info  选填   object

【单券模式信息】 单券模式配置信息,当且仅当 usage_mode 为 SINGLE 时选填(是否填写取决于是否需要填写内部字段),其他模式不应填写。

属性

 progressive_bundle_usage_info  选填   object

【多次优惠模式信息】 多次优惠模式配置信息,当且仅当 usage_mode 为 PROGRESSIVE_BUNDLE 时必传,其他模式不应填写。

属性

 display_info  必填   object

【展示信息】 商品券展示信息,展示结果可参考商品券示意图(单券模式)商品券示意图(多次优惠模式)

属性

 out_product_no  选填   string(40)

【外部商品ID】 品牌侧的商品标识,品牌可自行选择传入,长度不超过40个字符。

:微信支付不校验此参数的唯一性,即允许多个商品券共享外部商品ID。


 stock  选填   object

【批次】 商品券批次信息,当且仅当 usage_mode 不为 PROGRESSIVE_BUNDLE 时必传,其他模式不应填写。PROGRESSIVE_BUNDLE 模式下应使用 stock_bundle 字段

属性

 stock_bundle  选填   object

【批次组】 商品券批次组信息,当且仅当 usage_mode 为 PROGRESSIVE_BUNDLE 时必传,其他模式不应填写。

属性

 brand_id  必填   string

【品牌ID】 微信支付为品牌方分配的唯一标识,该品牌应与服务商存在授权关系

请求示例

curl
Java
Go

POST

创建满100可用的全场8折券

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/marketing/partner/product-coupon/product-coupons \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_product_no" : "Product_1234567890",
8    "scope" : "ALL",
9    "usage_mode" : "SINGLE",
10    "display_info" : {
11      "name" : "全场满100立打8折",
12      "image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
13      "background_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
14      "detail_image_url_list" : [
15        "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
16      ]
17    },
18    "single_usage_info" : {
19      "discount_coupon" : {
20        "threshold" : 10000,
21        "percent_off" : 20
22      }
23    },
24    "type" : "DISCOUNT",
25    "stock" : {
26      "remark" : "8月工作日有效批次",
27      "coupon_code_mode" : "UPLOAD",
28      "stock_send_rule" : {
29        "max_count" : 10000000,
30        "max_count_per_user" : 1
31      },
32      "single_usage_rule" : {
33        "coupon_available_period" : {
34          "available_begin_time" : "2025-08-01T00:00:00+08:00",
35          "available_end_time" : "2025-08-31T23:59:59+08:00",
36          "available_days" : 30,
37          "weekly_available_period" : {
38            "day_list" : [
39              "MONDAY",
40              "TUESDAY",
41              "WEDNESDAY",
42              "THURSDAY",
43              "FRIDAY"
44            ]
45          }
46        }
47      },
48      "usage_rule_display_info" : {
49        "coupon_usage_method_list" : [
50          "OFFLINE",
51          "MINI_PROGRAM",
52          "PAYMENT_CODE"
53        ],
54        "mini_program_appid" : "wx1234567890",
55        "mini_program_path" : "/pages/index/product",
56        "usage_description" : "工作日可用",
57        "coupon_available_store_info" : {
58          "description" : "所有门店可用,可使用小程序查看门店列表",
59          "mini_program_appid" : "wx1234567890",
60          "mini_program_path" : "/pages/index/store-list"
61        }
62      },
63      "coupon_display_info" : {
64        "code_display_mode" : "QRCODE",
65        "background_color" : "Color010",
66        "entrance_mini_program" : {
67          "appid" : "wx1234567890",
68          "path" : "/pages/index/product",
69          "entrance_wording" : "欢迎选购",
70          "guidance_wording" : "获取更多优惠"
71        },
72        "entrance_official_account" : {
73          "appid" : "wx1234567890"
74        },
75        "entrance_finder" : {
76          "finder_id" : "gh_12345678",
77          "finder_video_id" : "UDFsdf24df34dD456Hdf34",
78          "finder_video_cover_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
79        }
80      },
81      "store_scope" : "NONE",
82      "notify_config" : {
83        "notify_appid" : "wx4fd12345678"
84      }
85    },
86    "out_request_no" : "12345_20250101_A3489",
87    "brand_id" : "120344"
88  }'
89

创建全场折扣多次优惠券

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/marketing/partner/product-coupon/product-coupons \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "stock_bundle" : {
8      "remark" : "8月工作日有效批次",
9      "coupon_code_mode" : "UPLOAD",
10      "stock_send_rule" : {
11        "max_count" : 10000000,
12        "max_count_per_user" : 1
13      },
14      "progressive_bundle_usage_rule" : {
15        "coupon_available_period" : {
16          "available_begin_time" : "2025-08-01T00:00:00+08:00",
17          "available_end_time" : "2025-08-31T23:59:59+08:00",
18          "available_days" : 30,
19          "weekly_available_period" : {
20            "day_list" : [
21              "MONDAY",
22              "TUESDAY",
23              "WEDNESDAY",
24              "THURSDAY",
25              "FRIDAY"
26            ]
27          }
28        },
29        "discount_coupon_list" : [
30          {
31            "threshold" : 10000,
32            "percent_off" : 50
33          },
34          {
35            "threshold" : 10000,
36            "percent_off" : 20
37          },
38          {
39            "threshold" : 10000,
40            "percent_off" : 30
41          }
42        ]
43      },
44      "usage_rule_display_info" : {
45        "coupon_usage_method_list" : [
46          "OFFLINE",
47          "MINI_PROGRAM",
48          "PAYMENT_CODE"
49        ],
50        "mini_program_appid" : "wx1234567890",
51        "mini_program_path" : "/pages/index/product",
52        "usage_description" : "工作日可用",
53        "coupon_available_store_info" : {
54          "description" : "所有门店可用,可使用小程序查看门店列表",
55          "mini_program_appid" : "wx1234567890",
56          "mini_program_path" : "/pages/index/store-list"
57        }
58      },
59      "coupon_display_info" : {
60        "code_display_mode" : "QRCODE",
61        "background_color" : "Color010",
62        "entrance_mini_program" : {
63          "appid" : "wx1234567890",
64          "path" : "/pages/index/product",
65          "entrance_wording" : "欢迎选购",
66          "guidance_wording" : "获取更多优惠"
67        },
68        "entrance_official_account" : {
69          "appid" : "wx1234567890"
70        },
71        "entrance_finder" : {
72          "finder_id" : "gh_12345678",
73          "finder_video_id" : "UDFsdf24df34dD456Hdf34",
74          "finder_video_cover_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
75        }
76      },
77      "store_scope" : "NONE",
78      "notify_config" : {
79        "notify_appid" : "wx4fd12345678"
80      }
81    },
82    "out_product_no" : "Product_1234567890",
83    "scope" : "ALL",
84    "usage_mode" : "PROGRESSIVE_BUNDLE",
85    "display_info" : {
86      "name" : "全场多次折扣券",
87      "image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
88      "background_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
89      "detail_image_url_list" : [
90        "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
91      ]
92    },
93    "type" : "DISCOUNT",
94    "out_request_no" : "12345_20250101_A3489",
95    "progressive_bundle_usage_info" : {
96      "count" : 3,
97      "interval_days" : 1
98    },
99    "brand_id" : "120344"
100  }'
101

应答参数

200 OK

 product_coupon_id  必填   string(40)

【商品券ID】 商品券的唯一标识,本接口成功时由微信支付生成


 scope  必填   string

【优惠范围】 商品券优惠范围

可选取值

  • ALL:  全场券,此时券类型 type 仅可配置为 NORMAL 或 DISCOUNT

  • SINGLE:  单品券,此时券类型 type 配置不受限制,即可配置为 NORMALDISCOUNT 或 EXCHANGE


 type  必填   string

【商品券类型】 商品券的优惠类型

可选取值

  • NORMAL:  满减券

  • DISCOUNT:  折扣券

  • EXCHANGE:  兑换券,仅在 scope 为 SINGLE 时可配置


 usage_mode  必填   string

【使用模式】 商品券使用模式

可选取值

  • SINGLE:  单券,即用户只能使用一次,使用后券失效

  • PROGRESSIVE_BUNDLE:  多次优惠,由一组批次组成,每阶梯次序对应一个批次。用户按顺序使用,每次核销后发放下一张券,直到用完为止


 single_usage_info  选填   object

【单券模式信息】 单券模式配置信息,仅当 usage_mode 为 SINGLE 时提供,其他模式不提供。

属性

 progressive_bundle_usage_info  选填   object

【多次优惠模式信息】 多次优惠模式配置信息,当且仅当 usage_mode 为 PROGRESSIVE_BUNDLE 时提供,其他模式不提供。

属性

 display_info  必填   object

【展示信息】 商品券展示信息

属性

 out_product_no  选填   string

【外部商品ID】 商户创建商品券时主动传入的外部商品ID,原样返回


 state  必填   string

【商品券状态】 商品券状态

可选取值

  • AUDITING:  审批中,审批完成前商品券不可用

  • EFFECTIVE:  生效中,商品券已生效,可以正常使用

  • DEACTIVATED:  已失效,品牌方主动调用失效接口使商品券失效


 stock  选填   object

【批次】 商品券批次信息,当且仅当 usage_mode 为 SINGLE 时提供

属性

 stock_bundle  选填   object

【批次组】 商品券批次组信息,当且仅当 usage_mode 为 PROGRESSIVE_BUNDLE 时提供,其他模式不提供

属性

 brand_id  必填   string

【品牌ID】 微信支付为品牌方分配的唯一标识,该品牌应与服务商存在授权关系

应答示例

200 OK

创建满100可用的全场8折券

1{
2  "product_coupon_id" : "1000000013",
3  "scope" : "ALL",
4  "type" : "DISCOUNT",
5  "usage_mode" : "SINGLE",
6  "single_usage_info" : {
7    "discount_coupon" : {
8      "threshold" : 10000,
9      "percent_off" : 20
10    }
11  },
12  "display_info" : {
13    "name" : "全场满100立打8折",
14    "image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
15    "background_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
16    "detail_image_url_list" : [
17      "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
18    ]
19  },
20  "state" : "EFFECTIVE",
21  "out_product_no" : "Product_1234567890",
22  "stock" : {
23    "product_coupon_id" : "1000000013",
24    "stock_id" : "1000000013001",
25    "remark" : "8月工作日有效批次",
26    "coupon_code_mode" : "UPLOAD",
27    "coupon_code_count_info" : {
28      "total_count" : 0,
29      "available_count" : 0
30    },
31    "stock_send_rule" : {
32      "max_count" : 10000000,
33      "max_count_per_user" : 1
34    },
35    "single_usage_rule" : {
36      "coupon_available_period" : {
37        "available_begin_time" : "2025-08-01T00:00:00+08:00",
38        "available_end_time" : "2025-08-31T23:59:59+08:00",
39        "available_days" : 30,
40        "weekly_available_period" : {
41          "day_list" : [
42            "MONDAY",
43            "TUESDAY",
44            "WEDNESDAY",
45            "THURSDAY",
46            "FRIDAY"
47          ]
48        }
49      }
50    },
51    "usage_rule_display_info" : {
52      "coupon_usage_method_list" : [
53        "OFFLINE",
54        "MINI_PROGRAM",
55        "PAYMENT_CODE"
56      ],
57      "mini_program_appid" : "wx1234567890",
58      "mini_program_path" : "/pages/index/product",
59      "usage_description" : "工作日可用",
60      "coupon_available_store_info" : {
61        "description" : "所有门店可用,可使用小程序查看门店列表",
62        "mini_program_appid" : "wx1234567890",
63        "mini_program_path" : "/pages/index/store-list"
64      }
65    },
66    "coupon_display_info" : {
67      "code_display_mode" : "QRCODE",
68      "background_color" : "Color010",
69      "entrance_mini_program" : {
70        "appid" : "wx1234567890",
71        "path" : "/pages/index/product",
72        "entrance_wording" : "欢迎选购",
73        "guidance_wording" : "获取更多优惠"
74      },
75      "entrance_official_account" : {
76        "appid" : "wx1234567890"
77      },
78      "entrance_finder" : {
79        "finder_id" : "gh_12345678",
80        "finder_video_id" : "UDFsdf24df34dD456Hdf34",
81        "finder_video_cover_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
82      }
83    },
84    "notify_config" : {
85      "notify_appid" : "wx4fd12345678"
86    },
87    "store_scope" : "NONE",
88    "sent_count_info" : {
89      "total_count" : 0,
90      "today_count" : 0
91    },
92    "state" : "SENDING",
93    "brand_id" : "120344"
94  },
95  "brand_id" : "120344"
96}
97

创建全场折扣多次优惠券

1{
2  "product_coupon_id" : "1000000014",
3  "scope" : "ALL",
4  "type" : "DISCOUNT",
5  "usage_mode" : "PROGRESSIVE_BUNDLE",
6  "progressive_bundle_usage_info" : {
7    "count" : 3,
8    "interval_days" : 1
9  },
10  "display_info" : {
11    "name" : "全场满100立打8折",
12    "image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
13    "background_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx",
14    "detail_image_url_list" : [
15      "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
16    ]
17  },
18  "state" : "EFFECTIVE",
19  "out_product_no" : "Product_1234567890",
20  "stock_bundle" : {
21    "stock_bundle_id" : "712315129419284901",
22    "stock_list" : [
23      {
24        "product_coupon_id" : "1000000014",
25        "stock_id" : "1000000014001",
26        "remark" : "8月工作日有效批次",
27        "coupon_code_mode" : "UPLOAD",
28        "coupon_code_count_info" : {
29          "total_count" : 0,
30          "available_count" : 0
31        },
32        "stock_send_rule" : {
33          "max_count" : 10000000,
34          "max_count_per_user" : 1
35        },
36        "progressive_bundle_usage_rule" : {
37          "coupon_available_period" : {
38            "available_begin_time" : "2025-08-01T00:00:00+08:00",
39            "available_end_time" : "2025-08-31T23:59:59+08:00",
40            "available_days" : 30,
41            "weekly_available_period" : {
42              "day_list" : [
43                "MONDAY",
44                "TUESDAY",
45                "WEDNESDAY",
46                "THURSDAY",
47                "FRIDAY"
48              ]
49            }
50          },
51          "discount_coupon" : {
52            "threshold" : 10000,
53            "percent_off" : 50
54          }
55        },
56        "stock_bundle_info" : {
57          "stock_bundle_id" : "712315129419284901",
58          "stock_bundle_index" : 0
59        },
60        "usage_rule_display_info" : {
61          "coupon_usage_method_list" : [
62            "OFFLINE",
63            "MINI_PROGRAM",
64            "PAYMENT_CODE"
65          ],
66          "mini_program_appid" : "wx1234567890",
67          "mini_program_path" : "/pages/index/product",
68          "usage_description" : "工作日可用",
69          "coupon_available_store_info" : {
70            "description" : "所有门店可用,可使用小程序查看门店列表",
71            "mini_program_appid" : "wx1234567890",
72            "mini_program_path" : "/pages/index/store-list"
73          }
74        },
75        "coupon_display_info" : {
76          "code_display_mode" : "QRCODE",
77          "background_color" : "Color010",
78          "entrance_mini_program" : {
79            "appid" : "wx1234567890",
80            "path" : "/pages/index/product",
81            "entrance_wording" : "欢迎选购",
82            "guidance_wording" : "获取更多优惠"
83          },
84          "entrance_official_account" : {
85            "appid" : "wx1234567890"
86          },
87          "entrance_finder" : {
88            "finder_id" : "gh_12345678",
89            "finder_video_id" : "UDFsdf24df34dD456Hdf34",
90            "finder_video_cover_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
91          }
92        },
93        "notify_config" : {
94          "notify_appid" : "wx4fd12345678"
95        },
96        "store_scope" : "NONE",
97        "sent_count_info" : {
98          "total_count" : 0,
99          "today_count" : 0
100        },
101        "state" : "SENDING",
102        "brand_id" : "120344"
103      },
104      {
105        "product_coupon_id" : "1000000014",
106        "stock_id" : "1000000014002",
107        "remark" : "8月工作日有效批次",
108        "coupon_code_mode" : "UPLOAD",
109        "coupon_code_count_info" : {
110          "total_count" : 0,
111          "available_count" : 0
112        },
113        "stock_send_rule" : {
114          "max_count" : 10000000,
115          "max_count_per_user" : 1
116        },
117        "progressive_bundle_usage_rule" : {
118          "coupon_available_period" : {
119            "available_begin_time" : "2025-08-01T00:00:00+08:00",
120            "available_end_time" : "2025-08-31T23:59:59+08:00",
121            "available_days" : 30,
122            "weekly_available_period" : {
123              "day_list" : [
124                "MONDAY",
125                "TUESDAY",
126                "WEDNESDAY",
127                "THURSDAY",
128                "FRIDAY"
129              ]
130            }
131          },
132          "discount_coupon" : {
133            "threshold" : 10000,
134            "percent_off" : 20
135          }
136        },
137        "stock_bundle_info" : {
138          "stock_bundle_id" : "712315129419284901",
139          "stock_bundle_index" : 1
140        },
141        "usage_rule_display_info" : {
142          "coupon_usage_method_list" : [
143            "OFFLINE",
144            "MINI_PROGRAM",
145            "PAYMENT_CODE"
146          ],
147          "mini_program_appid" : "wx1234567890",
148          "mini_program_path" : "/pages/index/product",
149          "usage_description" : "工作日可用",
150          "coupon_available_store_info" : {
151            "description" : "所有门店可用,可使用小程序查看门店列表",
152            "mini_program_appid" : "wx1234567890",
153            "mini_program_path" : "/pages/index/store-list"
154          }
155        },
156        "coupon_display_info" : {
157          "code_display_mode" : "QRCODE",
158          "background_color" : "Color010",
159          "entrance_mini_program" : {
160            "appid" : "wx1234567890",
161            "path" : "/pages/index/product",
162            "entrance_wording" : "欢迎选购",
163            "guidance_wording" : "获取更多优惠"
164          },
165          "entrance_official_account" : {
166            "appid" : "wx1234567890"
167          },
168          "entrance_finder" : {
169            "finder_id" : "gh_12345678",
170            "finder_video_id" : "UDFsdf24df34dD456Hdf34",
171            "finder_video_cover_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
172          }
173        },
174        "notify_config" : {
175          "notify_appid" : "wx4fd12345678"
176        },
177        "store_scope" : "NONE",
178        "sent_count_info" : {
179          "total_count" : 0,
180          "today_count" : 0
181        },
182        "state" : "SENDING",
183        "brand_id" : "120344"
184      },
185      {
186        "product_coupon_id" : "1000000014",
187        "stock_id" : "1000000014003",
188        "remark" : "8月工作日有效批次",
189        "coupon_code_mode" : "UPLOAD",
190        "coupon_code_count_info" : {
191          "total_count" : 0,
192          "available_count" : 0
193        },
194        "stock_send_rule" : {
195          "max_count" : 10000000,
196          "max_count_per_user" : 1
197        },
198        "progressive_bundle_usage_rule" : {
199          "coupon_available_period" : {
200            "available_begin_time" : "2025-08-01T00:00:00+08:00",
201            "available_end_time" : "2025-08-31T23:59:59+08:00",
202            "available_days" : 30,
203            "weekly_available_period" : {
204              "day_list" : [
205                "MONDAY",
206                "TUESDAY",
207                "WEDNESDAY",
208                "THURSDAY",
209                "FRIDAY"
210              ]
211            }
212          },
213          "discount_coupon" : {
214            "threshold" : 10000,
215            "percent_off" : 30
216          }
217        },
218        "stock_bundle_info" : {
219          "stock_bundle_id" : "712315129419284901",
220          "stock_bundle_index" : 2
221        },
222        "usage_rule_display_info" : {
223          "coupon_usage_method_list" : [
224            "OFFLINE",
225            "MINI_PROGRAM",
226            "PAYMENT_CODE"
227          ],
228          "mini_program_appid" : "wx1234567890",
229          "mini_program_path" : "/pages/index/product",
230          "usage_description" : "工作日可用",
231          "coupon_available_store_info" : {
232            "description" : "所有门店可用,可使用小程序查看门店列表",
233            "mini_program_appid" : "wx1234567890",
234            "mini_program_path" : "/pages/index/store-list"
235          }
236        },
237        "coupon_display_info" : {
238          "code_display_mode" : "QRCODE",
239          "background_color" : "Color010",
240          "entrance_mini_program" : {
241            "appid" : "wx1234567890",
242            "path" : "/pages/index/product",
243            "entrance_wording" : "欢迎选购",
244            "guidance_wording" : "获取更多优惠"
245          },
246          "entrance_official_account" : {
247            "appid" : "wx1234567890"
248          },
249          "entrance_finder" : {
250            "finder_id" : "gh_12345678",
251            "finder_video_id" : "UDFsdf24df34dD456Hdf34",
252            "finder_video_cover_image_url" : "https://wxpaylogo.qpic.cn/wxpaylogo/xxxxx/xxx"
253          }
254        },
255        "notify_config" : {
256          "notify_appid" : "wx4fd12345678"
257        },
258        "store_scope" : "NONE",
259        "sent_count_info" : {
260          "total_count" : 0,
261          "today_count" : 0
262        },
263        "state" : "SENDING",
264        "brand_id" : "120344"
265      }
266    ]
267  },
268  "brand_id" : "120344"
269}
270

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

400

INVALID_REQUEST

传入参数不符合业务规则

请参考文档中对每个字段的要求以及组合要求,确认请求参数是否满足

400

ALREADY_EXISTS

商品券已存在

确认 out_request_no 字段是否重复使用,确保不同请求的 out_request_no 唯一

429

RATELIMIT_EXCEEDED

请求超过接口频率限制

请稍后使用原参数重试

 

元宝AI
反馈
目录
置顶