常见问题

更新时间：2025.06.05

A：通过互联网https ，有两个API，一个是上传文件，另一个是查询结果

A：快捷交易协议号是用户在微信支付绑卡后银行侧返回的数据，协议号相关的逻辑由银行侧制定。

A：不会，活动给用户曝光前会校验用户当前的绑卡状态。

A：只支持TXT或CSV格式的纯文本文件，每行一个加密后的协议号，换行符使用\n，编码格式使用utf-8。使用微信支付平台证书中的公钥逐个加密协议号。文件大小不能超过2MB，单个文件的行数不超过5500行。同一个号码包的多个上传任务的文件名不可重复。

A：一个号码包支持上传多个文件，单商户号单日最多 6000 个文件。单个文件的体积不能超过2MB，单个文件最多支持上传5500条快捷交易协议号。如果有大量协议号，可分为多日上传。

A：不考虑排队的情况下：单个文件(5500行)上传后大概40分钟处理完毕，每小时能处理130万条快捷交易协议号。1,000万条快捷交易协议号，预计耗时大概8小时。

由于同一时间可能还有其他商户在上传，按顺序处理，具体处理耗时视实际情况而定。建议做活动前一两天开始上传号码包。

A：号码包上传成功后，不支持删除协议号。若有删除协议号的需求，可以删除整个号码包，重新创建新的号码包即可。

A：目前收银台立减，在活动创建并激活后开始将号码包内的用户导入活动，大概2h后导包完成就会开始曝光。在活动激活后，商户即便继续往号码包上传协议号，这些协议号对应的用户也不会被导入活动，也就无法参加该活动。所以请确保在活动创建前，完成号码包的上传。

目前上传中的号码包不支持终止上传，若不需要该号码包，可以在上传成功之后在商户平台删除该号码包，该号码包则不会在可用商户号侧展示。

A：任务状态有两个：处理中和已完成。文件上传后状态是处理中，微信后台处理完之后，会将状态扭转为已完成。这时候调用“查询上传任务列表API”可以看到匹配成功数、失败数等结果。

A：请按以下步骤排查：

协议号解密异常：
- 未使用平台证书公钥进行加密；
- Wechatpay-Seria 未传递所使用的平台证书的序列号；
- 加密方法不对（调用API上传成功了的话，基本可排除这个原因）
协议号对应卡号不存在
卡号对应的微信账户不存在（绑卡签约状态为锁定、作废，即用户取消绑卡，或用户注销微信支付账户）
协议号绑定渠道并非微信。可能是qq钱包或其他渠道，建议过滤掉非微信渠道的快捷交易协议号；
微信侧网络抖动（概率极小）。

A：上传用户数据为绑卡协议号，最终会被解析为微信号。可能存在一条绑卡协议号对应多个微信号，此时上传成功用户数可能大于实际上传用户数；有些绑卡协议号无对应的微信号（可参考第11点），此时上传成功用户数可能小于实际上传用户数。通常一次上传的协议号文件里，两种情况都包含，故数量上会有差异。

另外，匹配成功率也跟银行圈选协议号时的特征有关。比如，圈选的是活跃用户包，则匹配成功率高；圈选的是沉默用户包，匹配的成功率相对低，因为一些沉默用户可能把卡解绑了，就匹配不到。

A：目前不支持查看号码包内具体哪些用户被曝光。但是如果号码包用于投放立减活动，则可以下载核销明细查看。

A：导入定向用户协议号API的频率限制：每秒3次，24小时6000次，查询上传任务列表API的频率限制：每秒30次

A：为了让银行的内网系统能够访问微信支付的API接口，可以通过以下方法解决：

方法一：使用 IP 地址而非域名访问

方法二：设置内部网络代理

方法三：DMZ

注意：在实施任何解决方案时，请务必遵循银行及相关监管机构的安全和合规要求。如有疑问，请务必与负责网络安全的IT团队和管理层协商，以确保遵循合规要求和安全实践。

A：增量。现在一个号码包支持陆续上传多个协议号文件，文件中的协议号会用来匹配微信号，将匹配到的微信号去重，保存到号码包。

注意：

根据以往经验，节假日前两三天可能有多个银行同时上传大量号码包文件，导致文件积压、处理耗时变长。建议提前上传（可以在节前一周陆续上传号码包）

文档是否有帮助

更多支持