支付接入FAQ选择字号：
&支付接入流程相关
1. 接入支付的整体流程是怎样的，需要花费多长时间？
整体接入支付流程详见的文档说明。由于提供了自助申请环境，以及沙箱环境给开发者联调，且审核为轻量级，所以接入支付花费的时间大部分取决于开发者的开发和联调速度。
2. 什么样的应用可以接入支付？
已经上线朋友应用推荐区，并且已获得授权的应用，才能接入支付。如下图所示：
3. 如何申请接入
开发者在“我的应用控制台”的“支付结算”页面，可以看到“申请接入”按钮，点击进入，填写相关信息，如下图所示：
上述信息在提交上线申请前都可以进行修改。需要注意的是：（1）虚拟货币：指应用内部的支付币，例如：在“摩天大楼”应用中，虚拟货币是“大楼币”。虚拟货币可通过Q点/Q币购买，或者通过财付通游戏子帐户购买，其数额存储在腾讯平台。 虚拟货币不能兑换回Q点/Q币。虚拟货币名称必须是唯一的，即如果你填写的虚拟币名称已经存在了，请换一个虚拟币名称。 （2）测试环境IP以及正式环境IP：注意是应用自己的服务器IP，不是OpenAPI的IP。用于OpenAPI调用前的授权。（3）发货URL用来给腾讯计费后台回调。付费成功后，腾讯计费后台将回调该URL给用户发货。-发货URL只需HTTP协议即可，不需要使用SSL安全协议。-发货URL的IP必须使用应用发货服务器的内网IP。-必须使用9001端口。（4）发货服务器IP是指发货服务器的内网IP地址。如果只有一台发货服务器，则IP2请填写与IP1一致即可。IP请提前规划好。考虑到系统的稳定性，支付申请审核通过后，一般情况下该IP不允许修改。如果必须要修改，请发邮件至申请，邮件内注明应用名称、修改信息。
4. 申请接入的时候，提示虚拟货币已经存在？
虚拟货币名称必须是唯一的，即如果你填写的虚拟币名称已经存在了，请换一个虚拟币名称。
1. 道具定价有最低限制？
是的。第三方应用在遵循腾讯制定的定价规范的前提下对应用内的道具进行定价。 请通过联系支付和黄钻接入的产品经理，获取道具定价规范。
2. 调用qz_buy_goods接口获取token信息时需要使用什么协议？
是否需要校验cpay证书的合法性？调用接口时，请使用HTTPS协议。不需要校验cpay证书，因为该证书是由腾讯计费平台自己生成的，可保证安全性。
3. 调用qz_buy_goods接口时需要传入userip，如何得到用户最终IP？
应用服务器得到的remote_ip和x_forward_ip是10.x.x.x，由上一层腾讯路由转发。
http请求的头里有一个QVia（HTTP_QVIA值），是个40个字节的串，前8个字节是IP，后面的是校验，将字节串前8个字节，分成4段，分别由16进制转成10进制，即可得到用户最终IP。
4. 支付申请通过后，还可以修改发货服务器IP或URL吗？
发货服务器IP以及URL请提前规划好。考虑到系统的稳定性，支付功能上线后，一般情况下该IP不允许修改。如果必须要修改，请发邮件至cpay_申请，邮件内注明应用名称、修改信息。
5. 应用首页强烈建议默认不展示支付币余额
应用首页应该默认不展示支付币余额（即不要调用接口，否则会对该接口造成很大压力）。（1）首页仅展示应用内部的金币余额。如下图所示：&
（2）点击查询支付币后，才调用来获取支付币余额，如下图所示：&&
&测试联调相关
1. 如何进行支付功能的测试？
如何给测试QQ帐号充Q币和游戏币？申请支付接入并提交应用基本资料后，腾讯后台会为该应用准备沙箱环境，便于应用进行测试和联调。在应用控制台的“支付结算tab”，可看到Q点充值，Q点余额查询，测试用游戏币充值，测试用游戏币余额查询，测试用游戏币流水查询等联调工具，如下图所示：&&
注意：沙箱环境不是正式环境，即对QQ帐号的充值操作的结果不会反映到现网中，只能通过沙箱环境下的余额查询工具获知余额变化。 开发者可以利用上述充值工具对某个QQ号码进行充值，在应用中进行购买操作后，可以利用上述余额查询工具查看是否扣款成功，并通过流水查看工具查看流水。
2. 为什么总是返回“1000：请求参数数错误”？
1. 生成sig的时候：（1）把device也作为签名的因子了。注意sig生成时具体需要包含哪些参数，见各接口参数说明中关于sig的描述。
（2）拼接字符串时，没有将key排序后，再进行key-value字符串拼接。
（3）拼接字符串时，把‘=’，‘&’也放签名原串里面了。注意只拼接key和它对应的value。
建议开发者按照API接口示例中的HTTP请求源串自行生成sig，然后和示例中的sig进行比对，如果不同，说明生成过程有误，请按中的步骤仔细检查，重新生成。
2. 测试环境和正式环境下OpenAPI的IP地址是不一样的，测试联调的IP是119.147.19.43，不要联调到正式环境上。
3. 如果上述原因都排除，还是出现请求参数错误，请联系的支付API技术支持人员，提供同一次请求里面的信息：（1）HTTP请求源串。（2）实现签名时，做md5前的原串和md5后的签名。
3. 测试时需要检查哪些项？
开发者请根据中给出的checklist进行测试，并填写测试报告（申请上线时需要提交该报告）。
4. 怎样知道调用的是测试环境还是正式环境的OpenAPI？
道具场景下，测试的OpenAPI的IP：119.147.19.43 ，正式的OpenAPI的IP：119.147.74.44 。
5. OpenAPI的测试IP只有一个，我有多个应用，可以重复使用这个测试IP吗？
可以。腾讯后台会根据请求中的appid判断是哪一个应用。
6. 我的测试QQ之前有个A应用的游戏币，现在测试另一个B应用需要再充值吗？
需要再充值。每个应用对应的游戏币是不一样的，A应用中的游戏币，不能在B游戏币里用。
7. 第三方机器连接https服务器时报错：“...https: not supported!”
详细报错信息：“curl 1-libcurl was built with SSL disabled, https: not supported!”。请注意如果是使用curl命令来连接https服务器，需要curl库编译时支持ssl。
8. 调用qz_buy_goods时报错：{"ret":-182,"msg":"app ip is invalid"}
-182属于系统内部错误。请通过联系OpenAPI支持人员，调查问题原因并获得解决方案。
9. 调用qz_buy_goods时可使用80端口联调，但是现网却不能使用？
为了提供协议安全性，Q点直购道具接口必须使用https协议传输。在测试环境下联调时请使用https协议（443端口）进行联调。
10. 购买的时候单位是Q点，支付和对账的时候单位是0.1Q点？
是的。详见中关于amt参数的说明：amt为支付总金额，以0.1Q点为单位。即如果总金额为4Q点，则amt的值是40。的时候注意单位的转换。
11. 回调第三方发货时，发货主备IP什么时候切换？
发货的主机和备机的IP是负载均衡的，如果某个服务器出问题，就切换至另一台服务器。出现问题的场景包括：连接出错、超时和404，其他情况不切换。
12. Q点直购联调时调用前台JS API，API弹框出现“交易流水不存在”？
联调有2个步骤：（1）获取token；（2）调用JS API展现页面。
造成该问题的原因有2种：1. 上述2个步骤都涉及到正式环境和测试环境，2个步骤里的信息必须要一致，即都采用测试环境下的信息，或者都采用正式环境下的信息。不然就会出现“交易流水不存在”。 2. token的有效期是15分钟。过了15分钟后token失效，再调用支付页面时会出现流水号过期或者流水号不存在。
13. “SSL3_GET_SERVER_CERTIFICATE:certificate verify failed”？
调用接口时，返回如上错误。原因是第三方应用在连接腾讯的服务器时，默认需要验证腾讯CPay证书。请改为不需要默认证书即可。
14. 访问qz_buy_goods时返回-194错误：“app has no privilege to use this api”？
该错误是由于应用不具备访问权限造成的。应用首先需检查自己的发货URL是否正确：必须默认为9001端口；如果发货URL没有问题，请通过联系运维支持人员，打开该接口的授权。
&1. 哪里可以查看对账单？对账单格式说明是什么？
在应用控制台的“支付结算”tab下，点击左侧导航树上的“自助对账”标签，即可下载每日对账单。详见：。
2. 对账信息是包含买道具的记录，还是买游戏币的记录？
对账信息是包含用户使用支付币购买游戏道具的记录。
3. 消费是指用QB买游戏币，还是用游戏币购买道具？
充值是指用QB或财付通子账户买游戏币；消费是指用游戏币购买道具。
4. 如何查询用户的消费记录？
（1）应用可以直接通过访问URL：<A href="/qzone/account/go//qzone/account/go/<YOURAPPID& 来下载对账单。 （2）也可以在应用控制台的“支付结算”tab下，点击左侧导航树上的“自助对账”标签，即可下载每日对账单。
5. 为什么下载账单里的总数额和页面上展示的消耗总额不一样？
下载的对账单里的记录包括支付和支付取消的，而页面上展示的消耗总额是所有的支付总额，不包括支付取消的，所以会有差异。
6. Q点直购道具场景下的对账数据是隔天的吗？
是的。每天早上11：00后会展现昨天（00：00-24：00）的对账数据。
&用户充值相关
1. 用户怎样买到我们的游戏币？
可以通过财付通游戏子账户购买游戏币，也可以先买QB，再用QB买游戏币。
2. 充值是充QB吗？
不是的，这里的充值都是指充游戏里的游戏币。
3. 财付通里显示账户有余额，为什么购买游戏币时提示余额不够？
财付通账户跟财付通游戏子账户不是一个概念，可通过如下链接上看自己的游戏子账户里是否有余额：
如果没有，去 上充值。
4. 怎样让我的游戏能跳转到上的页面去让用户充值？
不推荐用这样的方式，建议采用ingame的充值方式直接在游戏里完成充值，游戏币充值前台接口：。
5. Ingame充值，有其他游戏实例可供参考么？
请参考制作应用中的Ingame充值。
6. 怎样用财付通买游戏币？
先确保财付通游戏子账户里充足的余额，然后在弹出的充值页面，选择用财付通支付就可以了。
7. 怎样查询我的Q点余额？
用户在应用的导航条上可以看到“Q点查询”的tab，点击进入即可看到Q点余额页面。也可通过URL直接查询：
注：建议开发者在应用中调用前台接口：，直接弹出查询框，而不是跳转到Q点余额页面。
支付技术支持支付API调用发生错误，或进行支付功能相关的联调出现错误时，可通过联系支付技术支持，进行咨询。
以上信息是否已解决您的问题？
关注微信公众号
关注手Q公众号
社交软件热线3
帐号服务热线6
公众平台热线8
财付通热线0
支付服务热线95017
目前仅提供以上业务的电话服务，其他产品请在本网站寻求帮助
微信端公众号
QQ端公众号支付错误码说明
1. 支付后台接口的返回码与OpenAPI返回码一致，详见：。
2. 在Q点直购联调中，会遇到“支付失败”的错误提示。为帮助开发者联调，特别提供了更详细的联调错误码。
点开“详细错误信息”，可以看到一串错误码。如果遇到这些错误提示，请根据错误码并参照下文建议进行错误排查。
错误码解释：开发者调用v3/pay/buy_goods接口时，请求参数不合法。
处理建议：
1. 请参照检查参数是否符合协议规范。
2. 通过日志查看支付返回的错误描述。
特别提示：
遇到下面的部分错误码时，需要通过tcpdump获取9001端口的数据包以检查返回内容是否合法。
正确的命令如下：
tcpdump -i [ethx]
src host [ip] and port 9001 -X -v -s0
[]中的ethx请替换为发货服务器网卡，如eth0或eth1。
[]中的ip请替换为发货服务器的ip。
错误码解释：调用发货通知过早，订单尚未挂起。
处理建议：开发者可稍候再试（可等待几秒后，重复通知）。
错误码解释：平台后台系统设置错误。
处理建议：请及时联系开放平台企业QQ协助处理。
错误码解释：分区发货配置不匹配。
处理建议：开发者检查更新的分区发货信息是否及时同步。
错误码解释：支付失败，账户余额不足。
处理建议：登录“管理中心”，点击“支付结算”tab，在最下方点击“联调工具”进行测试Q点充值。
错误码解释：购买业务金额参数错误。
处理建议：检查接口payitem中的单价price(最小单位2Q点)和数量num的参数值(最大9999)。
错误码解释：单笔交易金额超过限制。
处理建议：单笔交易金额不能超过2000QB。
错误码解释：账户不存在。
处理建议：开发者检查帐户是否建立，可尝试充值Q点，或检查环境是否匹配。
错误码解释：交易金额超过代用币单日最高限制。
处理建议：交易金额不能超过10000QB/天。
错误码解释：购买业务金额参数错误。
处理建议：检查接口payitem中的单价price(最小单位2Q点)和数量num的参数值(最大9999)。
错误码解释：连续请求失败次数超过限制，业务暂时被锁定。
处理建议：开发者检查自身网关后，可过段时间重试。造成错误的原因可能有：网关不可用，返回格式错误，返回时间超过协议时间。
如果请求连续失败20次，业务将被锁定20秒；如果5分钟内请求次数大于30次，且发货网关调用开发者接口的错误率超过50%，业务将被锁定20秒。
错误码解释：zoneid参数错误。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：IP链接失败。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：开发者发货网关返回{"ret":-1,"msg":""}。
处理建议：开发者检查自身定义的返回码为-1所对应的描述，并通过tcpdump获取9001端口的数据包以检查返回内容。
错误码解释：开发者发货网关返回{"ret":1,"msg":""}。
处理建议：开发者检查自身定义的返回码为1所对应的描述，并通过tcpdump获取9001端口的数据包以检查返回内容。
错误码解释：开发者发货网关返回{"ret":2,"msg":""}。
处理建议：开发者检查自身定义的返回码为2所对应的描述，并通过tcpdump获取9001端口的数据包以检查返回内容。
错误码解释：开发者发货网关返回{"ret":3,"msg":""}。
处理建议：开发者检查自身定义的返回码为3所对应的描述，并通过tcpdump获取9001端口的数据包以检查返回内容。
错误码解释：开发者发货网关返回{"ret":4,"msg":""}。
处理建议：开发者检查自身定义的返回码为4所对应的描述，并通过tcpdump获取9001端口的数据包以检查返回内容。
错误码解释：其他错误。
处理建议：开发者检查应用程序和配置是否有误，并通过tcpdump获取9001端口的数据包以检查返回内容是否合法。
错误码解释：错误的请求，开发者发货网关返回http 400。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：请求被禁止，开发者发货网关返回http 403。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：CGI不存在，开发者发货网关返回http 404。
处理建议：开发者按照错误码解释检查发货网关的发货CGI是否可访问。
错误码解释：请求超时，开发者发货网关返回http 408。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：请求url太长，开发者发货网关返回http 414。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：调用开发者发货网关返回http 497，http请求发送到https端口上。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：调用开发者发货网关返回http 500。
处理建议：开发者webserver发生500的内部错误，具体信息请tcpdump数据包以检查返回内容。
错误码解释：cee_extend参数错误。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：（对不起，交易流水不存在）token过期，需要重新获取。一般是前后端接口调用环境不一致，需要统一使用沙箱或者现网环境，参考处理建议。
处理建议：
服务器端/v3/pay/buy_goods沙箱需用119.147.19.43（CEE：1.254.254.22）发起请求（现网使用域名）
前端fusion2.dialog.buy沙箱设置sandbox:true（现网false）
服务器端/mpay/buy_goods_m沙箱需用119.147.19.43（CEE：1.254.254.22）发起请求（现网使用域名）
客户端支付初始化的时候，setEnv沙箱设置为test（现网release）
如上检查均正常，可能是如下少见的情况：
应用侧这边在服务端获取url_params值后使用了比如换行符等特殊符号，并把这些带有特殊符号的值传入到前端使用时也会出现这个错误码。
错误码解释：没有接入支付。
处理建议：开发者检查应用是否已申请接入支付，或检查APPID是否有误。
错误码解释：应用配置信息未同步。
处理建议：开发者检查应用分区配置是否完成同步，同步方法：登录“管理中心”，点击“支付结算”tab，在“支付接入”页面点击“修改分区信息”，确认分区发货信息正确后，点击“同步到沙箱”或“同步到现网”。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：您本次操作需要验证密保，请绑定QQ安全中心手机版后重试：/app。
错误码解释：消费操作存在风险。
处理建议：如果您是游戏玩家，请先修改QQ密码后尝试消费（/gm）。如果依然报错，请联系游戏客服人员。如果您是游戏开发商，此错误码一般出现在沙箱测试环境，如果沙箱环境全部测试帐号都报错，请立刻联系企业QQ处理。如果是个别现网玩家反馈，建议改密（/gm）或者联系企业QQ。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请绑定密保手机后验证密保即可消费！/sj。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请绑定密保手机后验证密保即可消费！/sj。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请绑定密保手机后验证密保即可消费！/sj。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：为了保障您的财产安全，赠送双方需要满足7天以上QQ好友关系！
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请绑定密保手机后验证密保即可消费！/sj。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请绑定密保手机后验证密保即可消费！/sj。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请绑定密保手机后验证密保即可消费！/sj。
错误码解释：用户设置或策略要求验密保，用户没有密保导致禁止消费。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请绑定密保手机后验证密保即可消费！/sj。
错误码解释：触发平台相关策略导致消费被禁止。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请改密后再试！/gm。
错误码解释：触发平台相关策略导致消费被禁止。
处理建议：QQ帐号存在安全风险，为确保Q币安全，请改密后再试！/gm。
错误码解释：触发平台相关策略导致消费被禁止。
处理建议：网络环境存在安全风险，为确保Q币安全，请稍后再试！
错误码解释：系统错误。
处理建议：请直接联系企业QQ协助处理。
错误码解释：交易超时。
处理建议：请直接联系企业QQ协助处理。
错误码解释：频率限制。
处理建议：请直接联系企业QQ协助处理。
错误码解释：频率限制。
处理建议：请直接联系企业QQ协助处理。
错误码解释：调用充值游戏币接口fusion2.dialog.pay出现未授权。
处理建议：Q点直购不允许调用充值接口，需接入道具寄售模式。
错误码解释：开发者返回信息不合法。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误，并通过tcpdump获取9001端口的数据包以检查返回内容是否合法。
错误码解释：颁发的证书不合法或SSL连接异常。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：CA根证书不合法。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：curl链接建立但返回超时。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误。
错误码解释：JSON解析错误，开发者发货网关返回信息不符合JSON格式，通常是开发者发货CGI逻辑出错，返回一段错误信息。
处理建议：开发者按照错误码解释检查应用程序和配置是否有误，并通过tcpdump获取9001端口的数据包以检查返回内容是否合法。
正常返回示例：{"ret":0,"msg":"OK"}。
错误码解释：调用开发者发货网关返回http 502。
处理建议：开发者检查自身发货网关是否可用。造成错误的原因可能有：端口未启用，服务器配置不正确。
错误码解释：发货网关的协议要求在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打印出来的包序号不连续。
错误码解释：系统错误。
处理建议：系统错误，请通过联系支付技术支持人员。
开发者在联调的过程中，如遇到其他问题，可参考。}