常见问题
更新时间：2026.08.191、接入与权限
Q：user_package_id 可以自己生成吗？
A：不可以。必须由微信支付运营侧预先创建并下发（20 位定长）。不确定时请联系运营人员。
Q：接口报 403 NO_AUTH 怎么办？
A：这是业务权限问题，不是代码问题。常见原因：未开通人群包能力、权限被暂停、或使用了不属于本品牌的 user_package_id。请联系运营核查。
2、签名相关（业务特有）
签名验签通用说明见品牌API如何签名和验签。人群包额外注意：
Q：UploadPart 一直 SIGN_ERROR？
A：除通用签名问题外，UploadPart 签名 body 应使用 meta 字段的 JSON 字符串，不是整个 multipart 请求体。
Q：Wechatpay-Serial 和 serial_no 怎么区分？
A：Wechatpay-Serial 填微信支付公钥 ID（PUB_KEY_ID_xxx）；Authorization 中的 serial_no 填品牌 API 证书序列号。详见通用签名文档。
3、文件与上传
Q：part_number 从 0 还是 1 开始？分块大小可以自己定吗？
A：从 1 开始。分块大小必须严格使用初始化上传返回的 file_part_size。
Q：CompleteUpload 一直返回 NOT_FINISHED？
A：仍有分块未真正成功。对未明确成功的分块用相同 part_number 重传（覆盖幂等），全部成功后再合并。
Q：上传中途失败要不要从头重来？
A：初始化上传按「品牌ID + 文件名」幂等。相同文件名可拿回同一 upload_id 做断点续传；要开新会话须换文件名。详见开发指引。
4、生效与数据
Q：扩充返回 PROCESSING，多久生效？
A：只表示任务已提交。异步生效，大多数当天内，最长可能 T+2。无回调、无任务状态查询接口。
Q：接口都成功了，但入库用户数比上传少？
A：可能被静默过滤：OpenID 对应 appid 未绑定、手机号 MD5 不合规、文件含表头/多列/引号等。建议先用少量已知有效用户做最小样本验证。
Q：数据长时间没生效，可以重复提交吗？
A：不建议。T+2 后仍未生效时，保留各接口完整 Request-Id 与请求时间联系运营核查。
文档是否有帮助
