常见问题
更新时间：2025.04.091. 接口需要签名吗？签名公私钥怎么获得？
需要，每个接口都要签名；
签名秘钥、规则见 总述-APIv3如何签名和验签
2. 有SDK吗？
没有直接封装的sdk，但是可以用微信支付官方sdk简化签名验签流程。
注：vivo反馈，wechatpay-java v0.2.16库有已知问题：中文字符串请求，返回签名报错。可以尝试微信支付 APIv3 Apache HttpClient装饰器（decorator）、okhttpclient。
3. 显示没权限
有基于商户号 + 对接地区的权限控制，需提前联系加白名单，否则会报错NOT_AUTH
4. 重庆、上海、江苏、福建怎么配置测试资格
请按下方邮件模板发送邮件申请测试商户号
|
|
5. 商家如何识别支付订单中的补贴优惠金额
可通过支付回调通知中的promotion_detail【优惠功能】下字段「amount」「stock_id」识别。在上线时微信支付对接人员将提供合作地区/品类对应的「stock_id」。
附：国补活动配置「stock_id」参考文档中的批次号：
V2接口通过字段「activity_id 」返回「stock_id」信息，需按照以下指引传参：
V2 的回调通知
6. 退款结果如何感知到是否享受国补、优惠金额是多少
可通过查询退款接口中「promotion_detail」下的匹配退款优惠金额
7. 资格查询接口怎么一直参数错误
针对接口 GET /v3/gov/subsidy/qualification
参数都在query里，需要对（身份证号、手机号、姓名）参数urlencode，参考文档后面的例子。
8. 接口限频与tps
接口 | tp99 | 限频 | 限频维度 |
|---|---|---|---|
/v3/gov/subsidy/qualification | 100ms | 1000 | 接口级 |
/v3/gov/subsidy/qualifications/sync | 250ms，强依赖省平台 | 100 | 接口级 |
/v3/gov/subsidy/transactions/sync | 250ms，强依赖省平台 | 100 | 接口级 |
/v3/gov/subsidy/sncode/query | 250ms，强依赖省平台 | 1000 | 接口级 |
/v3/gov/subsidy/sncode/lock | 300ms，强依赖省平台 | 1000 | 接口级 |
/v3/gov/subsidy/sncode/unlock | 300ms，强依赖省平台 | 1000 | 接口级 |
/v3/gov/subsidy/goods/upload | 200ms，强依赖省平台 | 100 | 接口级 |
/v3/gov/subsidy/n-qualifications/sync | 暂无 | 1000 | 接口级 |
/v3/gov/subsidy/qualifications/query | 100ms | 1000 | 接口级 |
9. 什么是sn码？
序列号（serial number）又称序号，是为了识别需要，分配给物品或特定主体的唯一标识符；在商品应用中，也是由厂商指定给每一硬件或软件单元的唯一的号码，类似人的身份证号。
在国补的场景里，只有3C品类会涉及到SN码。为了避免一机多售，在完成交易前需要调用锁定SN码接口，将对应商品通过SN码锁定，只有成功锁定SN的订单，最终才能完成核销。
