支付错误码说明

1. 支付后台接口的返回码与OpenAPI返回码一致,详见:公共返回码说明
2. 在Q点直购联调中,会遇到“支付失败”的错误提示。为帮助开发者联调,特别提供了更详细的联调错误码。
点开“详细错误信息”,可以看到一串错误码。如果遇到这些错误提示,请根据错误码并参照下文建议进行错误排查。
pay_wrongcode.png


目录

错误码:1001-1001-0

错误码解释:开发者调用v3/pay/buy_goods接口时,请求参数不合法。
处理建议
1. 请参照v3/pay/buy_goods#2.5 输入参数说明检查参数是否符合协议规范。
2. 通过日志查看支付返回的错误描述。


特别提示
遇到下面的部分错误码时,需要通过tcpdump获取9001端口的数据包以检查返回内容是否合法。
正确的命令如下:
tcpdump -i [ethx] src host [ip] and port 9001 -X -v -s0
[]中的ethx请替换为发货服务器网卡,如eth0或eth1。
[]中的ip请替换为发货服务器的ip。

错误码:1000-242-0

错误码解释:调用发货通知过早,订单尚未挂起。
处理建议:开发者可稍候再试(可等待几秒后,重复通知)。

错误码:1003-332-102

错误码解释:平台后台系统设置错误。
处理建议:请及时联系开放平台企业QQ协助处理。

错误码:1003-1-106

错误码解释:分区发货配置不匹配。
处理建议:开发者检查更新的分区发货信息是否及时同步。

错误码:1003-1-801

错误码解释:支付失败,账户余额不足。
处理建议:登录“管理中心”,点击“支付结算”tab,在最下方点击“联调工具”进行测试Q点充值。

错误码:1003--1-32004

错误码解释:购买业务金额参数错误。
处理建议:检查/v3/pay/buy_goods接口payitem中的单价price(最小单位2Q点)和数量num的参数值(最大9999)。

错误码:1003-27-27

错误码解释:单笔交易金额超过限制。
处理建议:单笔交易金额不能超过2000QB。

错误码:1003-131-102

错误码解释:账户不存在。
处理建议:开发者检查帐户是否建立,可尝试充值Q点,或检查环境是否匹配。

错误码:1003-151-151

错误码解释:交易金额超过代用币单日最高限制。
处理建议:交易金额不能超过10000QB/天。

错误码:1003-32004-32004

错误码解释:购买业务金额参数错误。
处理建议:检查/v3/pay/buy_goods接口payitem中的单价price(最小单位2Q点)和数量num的参数值(最大9999)。

错误码:1003-498493-106

错误码解释:连续请求失败次数超过限制,业务暂时被锁定。
处理建议:开发者检查自身网关后,可过段时间重试。造成错误的原因可能有:网关不可用,返回格式错误,返回时间超过协议时间。
如果请求连续失败20次,业务将被锁定20秒;如果5分钟内请求次数大于30次,且发货网关调用开发者接口的错误率超过50%,业务将被锁定20秒。

错误码:1003-498692-106

错误码解释:zoneid参数错误。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1003-498695-106

错误码解释:IP链接失败。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1003-499999-106

错误码解释:开发者发货网关返回{"ret":-1,"msg":""}。
处理建议:开发者检查自身定义的返回码为-1所对应的描述,并通过tcpdump获取9001端口的数据包以检查返回内容。

错误码:1003-500001-106

错误码解释:开发者发货网关返回{"ret":1,"msg":""}。
处理建议:开发者检查自身定义的返回码为1所对应的描述,并通过tcpdump获取9001端口的数据包以检查返回内容。

错误码:1003-500002-106

错误码解释:开发者发货网关返回{"ret":2,"msg":""}。
处理建议:开发者检查自身定义的返回码为2所对应的描述,并通过tcpdump获取9001端口的数据包以检查返回内容。

错误码:1003-500003-106

错误码解释:开发者发货网关返回{"ret":3,"msg":""}。
处理建议:开发者检查自身定义的返回码为3所对应的描述,并通过tcpdump获取9001端口的数据包以检查返回内容。

错误码:1003-500004-106

错误码解释:开发者发货网关返回{"ret":4,"msg":""}。
处理建议:开发者检查自身定义的返回码为4所对应的描述,并通过tcpdump获取9001端口的数据包以检查返回内容。

错误码:1003-500650-106

错误码解释:其他错误。
处理建议:开发者检查应用程序和配置是否有误,并通过tcpdump获取9001端口的数据包以检查返回内容是否合法。

错误码:1003-500850-106

错误码解释:错误的请求,开发者发货网关返回http 400。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1003-500853-106

错误码解释:请求被禁止,开发者发货网关返回http 403。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1003-500854-106

错误码解释:CGI不存在,开发者发货网关返回http 404。
处理建议:开发者按照错误码解释检查发货网关的发货CGI是否可访问。

错误码:1003-500858-106

错误码解释:请求超时,开发者发货网关返回http 408。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1003-500864-106

错误码解释:请求url太长,开发者发货网关返回http 414。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1003-500947-106

错误码解释:调用开发者发货网关返回http 497,http请求发送到https端口上。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1003-500950-106

错误码解释:调用开发者发货网关返回http 500。
处理建议:开发者webserver发生500的内部错误,具体信息请tcpdump数据包以检查返回内容。

错误码:1003-512001-106

错误码解释:cee_extend参数错误。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1005-1005-0

错误码解释:(对不起,交易流水不存在)token过期,需要重新获取。一般是前后端接口调用环境不一致,需要统一使用沙箱或者现网环境,参考处理建议。
处理建议
(PC端)
服务器端/v3/pay/buy_goods沙箱需用119.147.19.43(CEE:1.254.254.22)发起请求(现网使用域名openapi.tencentyun.com)
前端fusion2.dialog.buy沙箱设置sandbox:true(现网false)
(移动端)
服务器端/mpay/buy_goods_m沙箱需用119.147.19.43(CEE:1.254.254.22)发起请求(现网使用域名openapi.tencentyun.com)
客户端支付初始化的时候,setEnv沙箱设置为test(现网release)

如上检查均正常,可能是如下少见的情况:
应用侧这边在服务端获取url_params值后使用了比如换行符等特殊符号,并把这些带有特殊符号的值传入到前端使用时也会出现这个错误码。

错误码:1016-1016-0

错误码解释:没有接入支付。
处理建议:开发者检查应用是否已申请接入支付,或检查APPID是否有误。

错误码:1025-1025-0

错误码解释:应用配置信息未同步。
处理建议:开发者检查应用分区配置是否完成同步,同步方法:登录“管理中心”,点击“支付结算”tab,在“支付接入”页面点击“修改分区信息”,确认分区发货信息正确后,点击“同步到沙箱”或“同步到现网”。

错误码:1043-10053-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:您本次操作需要验证密保,请绑定QQ安全中心手机版后重试:aq.qq.com/app。

错误码:1043-10054-0

错误码解释:消费操作存在风险。
处理建议
如果您是游戏玩家,请先修改QQ密码后尝试消费(aq.qq.com/gm)。如果依然报错,请联系游戏客服人员。
如果您是游戏开发商,此错误码一般出现在沙箱测试环境,如果沙箱环境全部测试帐号都报错,请立刻联系企业QQ处理。如果是个别现网玩家反馈,建议改密(aq.qq.com/gm)或者联系企业QQ。

错误码:1043-10060-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请绑定密保手机后验证密保即可消费!aq.qq.com/sj。

错误码:1043-10068-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请绑定密保手机后验证密保即可消费!aq.qq.com/sj。

错误码:1043-10069-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请绑定密保手机后验证密保即可消费!aq.qq.com/sj。

错误码:1043-10111-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:为了保障您的财产安全,赠送双方需要满足7天以上QQ好友关系!

错误码:1043-10112-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请绑定密保手机后验证密保即可消费!aq.qq.com/sj。

错误码:1043-10113-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请绑定密保手机后验证密保即可消费!aq.qq.com/sj。

错误码:1043-103218-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请绑定密保手机后验证密保即可消费!aq.qq.com/sj。

错误码:1043-10219-0

错误码解释:用户设置或策略要求验密保,用户没有密保导致禁止消费。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请绑定密保手机后验证密保即可消费!aq.qq.com/sj。

错误码:1043-10220-0

错误码解释:触发平台相关策略导致消费被禁止。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请改密后再试!aq.qq.com/gm。

错误码:1043-10255-0

错误码解释:触发平台相关策略导致消费被禁止。
处理建议:QQ帐号存在安全风险,为确保Q币安全,请改密后再试!aq.qq.com/gm。

错误码:1043-10256-0

错误码解释:触发平台相关策略导致消费被禁止。
处理建议:网络环境存在安全风险,为确保Q币安全,请稍后再试!

错误码:1043--1-0

错误码解释:系统错误。
处理建议:请直接联系企业QQ协助处理。

错误码:1043-102-0

错误码解释:交易超时。
处理建议:请直接联系企业QQ协助处理。

错误码:1043-104-0

错误码解释:频率限制。
处理建议:请直接联系企业QQ协助处理。

错误码:1043-10234-0

错误码解释:频率限制。
处理建议:请直接联系企业QQ协助处理。

错误码:1045-1045-1045

错误码解释:调用充值游戏币接口fusion2.dialog.pay出现未授权。
处理建议:Q点直购不允许调用充值接口,需接入道具寄售模式。

错误码:1058-498001-40000

错误码解释:开发者返回信息不合法。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误,并通过tcpdump获取9001端口的数据包以检查返回内容是否合法。

错误码:1058-498197-40000

错误码解释:颁发的证书不合法或SSL连接异常。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1058-498198-40000

错误码解释:CA根证书不合法。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1058-498199-40000

错误码解释:curl链接建立但返回超时。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误。

错误码:1058-498496-40000

错误码解释:JSON解析错误,开发者发货网关返回信息不符合JSON格式,通常是开发者发货CGI逻辑出错,返回一段错误信息。
处理建议:开发者按照错误码解释检查应用程序和配置是否有误,并通过tcpdump获取9001端口的数据包以检查返回内容是否合法。
正常返回示例:{"ret":0,"msg":"OK"}。

错误码:1058-500952-40000

错误码解释:调用开发者发货网关返回http 502。
处理建议:开发者检查自身发货网关是否可用。造成错误的原因可能有:端口未启用,服务器配置不正确。

错误码:1058-500954-40000

错误码解释:发货网关的协议要求在2秒之内返回发货结果,开发者发货返回时间已超过协议时间。
处理建议:开发者按照协议规范在2秒之内返回发货结果。出现此错误开发者可按下面的步骤进行检查:
(1)通过telnet对应的IP和端口是否成功,例如telnet 192.168.1.123 443。
(2)通过curl工具拉取对应的url地址的数据是否成功。
(3)统计请求从接收到处理完耗时是否超过了2秒。
(4)查看web服务器进程是否存在,例如tomcat没有启动起来。
(5)检查服务器配置是否正确,例如nginx配置的反向代理不正确。
(6)检查是否配置IP限制策略。
(7)通过tcp抓包工具,如tcpdump,查看请求处理完之后tcp连接是否正常关闭,即抓包的是FIN包而不是RST包。
(8)查看网络是否有丢包现象,tcpdump抓包拿到请求的源IP,使用Ping命令,监控一段时间,看是否有丢包,即Ping打印出来的包序号不连续。

其他错误码

错误码解释:系统错误。
处理建议:系统错误,请通过企业QQ联系支付技术支持人员。


开发者在联调的过程中,如遇到其他问题,可参考支付测试联调相关问题

以上信息是否解决您的问题?

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部