云支付常见问题

目录

支付接入流程相关

1. 什么样的应用可以接入支付?

已经签订收益补充协议的应用(详见合同与收益),才能接入支付。

2. non-hosting应用可以接入支付吗?

支付接入已支持non-hosting应用接入。
即不管应用是否部署在腾讯的服务器上,只要签订了收益补充协议,都可以在open.qq.com的管理中心申请接入支付。

3. 接入支付的整体流程是怎样的,需要花费多长时间?

腾讯提供了自助申请接入支付的环境,并提供沙箱环境给开发者联调,所以接入支付花费的时间大部分取决于开发者的开发和联调速度。
我们强烈建议开发者在申请前就进行支付功能的开发。整体接入支付详见:支付接入流程

4. 申请接入支付的入口在哪?

开发者登录op.open.qq.com后进入管理中心,选择1个应用进入,可看到“支付结算”tab。
如果您的应用符合条件,则点击“支付结算”tab即可进入,在左侧导航中可看到“支付接入”,点击即进入支付接入申请页面。

5. 申请时填写的发货URL、IP、分区名称是什么意思?

在支付接入申请页面,你需要填写APP资料,并进行支付发货服务器的配置。
建议您阅读支付接入流程#1. 提交支付接入申请,获取发货URL、IP、分区名称等概念的解释和填写注意事项。

6. 可以随时修改发货服务器IP或URL吗?

可以。开发者可以自行在管理中心“支付结算”tab下的支付发货配置页面中进行配置。

7. 非游戏类应用在接入支付的同时,是否需要接入黄钻?

需要,支付功能必须和黄钻功能同时上线。
非游戏类应用接入黄钻时,只需要接入黄钻8折特权和黄钻标识两项即可。

支付产品设计相关

1. 支付和黄钻功能必须同时上线?

是的,接入支付的应用都必须接入黄钻体系,支付和黄钻功能必须同时上线。
由于黄钻特权内容的开发相对独立,建议应用尽早启动黄钻特权内容的开发,以缩短接入支付的时间。
黄钻特钻内容的开发详见:接入黄钻体系

2. 关于道具定价有相关的规定吗?

应用在对道具进行定价时,须遵循混腾讯制定的定价规范。
此外,黄钻用户享受道具8折的特权,用户支付时如果使用财付通游戏子账户付款,还享受财付通折扣。
详见:道具打折说明以及定价规范

3. 允许哪些道具购买的支付渠道?

腾讯对于道具的支付渠道没有限制,除了在“道具寄售”系统中可以使用游戏币外,不允许存在其他“通过付费获得的二级货币”。
即除Q点Q币/财付通游戏子账户/游戏币(只限于“道具寄售”系统)以外,其他所有的货币都只能通过平台或应用免费赠送的方式获取。
详见:货币体系与支付场景

4. 怎样进行Q点充值?

腾讯提供了前台接口:fusion2.dialog.recharge,用于应用内的Q点充值弹框。
应用需在应用内设置明显的“Q点充值”的按钮,用户点击即可打开Q点充值弹框。

5. 怎样查询Q点余额?

腾讯提供了前台接口:fusion2.dialog.checkBalance,用于应用内的Q点余额查询弹框。
应用需在应用内设置明显的“Q点查询”的按钮,用户点击打开Q点余额弹框。

6. 用户账户Q点余额显示有什么规范吗?

有,必须遵循腾讯开放平台支付接入规范中的“1.2 账户显示规范”,以及“1.3 账户图标规范”。

7. 应用中的商品信息的种类,命名,图片有什么规范吗?

有,必须遵循腾讯开放平台支付接入规范#3. 商品信息显示规范

8. 财付通和财付通子帐户有什么不同?

财付通账户跟财付通游戏子账户不是一个概念。财付通可以用来充值Q点,而财付通游戏子账户(现在已经改名为“微支付”)可以直接用来购买游戏商品。
财付通游戏子账户余额查询入口:https://www.tenpay.com/v2.0/main/gaccnt.shtml
财付通游戏子账户(现在已经改名为“微支付”)充值入口:https://www.tenpay.com/v2.0/main/gameaccount/charge.shtml

9. 应用接入支付功能后,如果活动中涉及到参与资格需要付费获得的,需要满足哪些条件?

应用不得以随机抽取等偶然方式,诱导网络游戏用户投入法定货币或者网络游戏虚拟货币,来获取网络游戏产品和服务。

支付功能开发相关

1. 如何进行支付功能的开发?

腾讯提供了支付相关的后台和前台接口,应用直接调用就可以实现前台交易和后台扣款,以及黄钻/财付通折扣、容错等逻辑。
详见: Q点直购道具开发说明道具寄售开发说明

2. 支付接口时需要使用HTTPS协议?

(1)调用v3/pay/buy_goods接口时,请使用HTTPS协议。开发者开发语言使用第三方库的时候,注意选择需要支持ssl。
(2) 对于non-hosting应用,还需要调用发货确认接口v3/pay/confirm_delivery,该接口也必须使用HTTPS协议。

3. cpay证书是什么?是否需要验证合法性?

cpay证书是由腾讯计费平台自己生成的用来校验通讯合法性的证书。
(1)对于hosting应用,应用部署在腾讯服务器上,和腾讯计费后台通讯时属于内网通讯,不需要校验cpay证书。
(2)对于non-hosting应用,应用部署在开发者自己的服务器上,为保证支付安全,必须在应用发货服务器上安装证书,用于支付交易通讯时的校验。证书的下载和安装详见:这里

4. 发货服务器必须使用9001端口?

(1)对于hosting应用,必须使用9001端口。
注意:hosting应用发货服务器也是部署在内网机器上,这里的9001端口实际上是内网端口,内网对端口不做限制,因此无需申请开通。

(2)对于non-hosting应用,必须使用443端口。

5. 发货服务器的主备IP作用是什么?什么时候切换?

发货的主机和备机的IP是负载均衡的,如果某个服务器出问题,就切换至另一台服务器。
出现问题的场景包括:连接出错、超时和404,其他情况不切换。

6. 支付的两种接入模式是否可以切换?

目前支付有两种接入模式:“Q点直购”和“道具寄售”。
应用在接入支付时,只能选择其中的一种模式接入。
应用接入其中的一种模式,通过后,不允许再切换到另外一种模式。

支付测试联调相关

1. 如何进行支付联调?在哪查看联调详细错误码?

腾讯为支付接入的应用提供了沙箱环境,沙箱环境包含Q点充值,Q点余额查询等测试联调工具。
为帮助开发者进行错误定位,支付联调还对错误场景进行了细分,提供了详细的联调错误码说明。
详见:支付联调说明

2. 支付接口总是返回“1000:请求参数错误”?

支付接口的测试环境和正式环境下OpenAPI的IP地址不一样,联调时请使用测试环境IP,发布时才切换到正式IP上。接口的正式IP和测试IP,详见支付接口文档中关于请求URL的说明。

3. 支付接口总是返回“-5:signature verification failed”?

这是调用V3版支付接口时,签名校验失败。有2种情况:
1. sig参数生成错误。
2. sig参数生成正确,但是参数传输前没有进行URL编码。
您可以参看:腾讯开放平台第三方应用签名参数sig的说明#常见错误排障

4. 怎样知道调用的是测试环境还是正式环境的API?

(1)对于OpenAPI,正式环境以及测试环境的IP和域名详见:API3.0文档#请求URL说明
(2)对于FusionAPI,请查看代码中的sandbox参数。sandbox为true则表示是测试环境; false或不指定则为正式环境不使用。

5. OpenAPI的测试IP只有一个,我有多个应用,可以重复使用这个测试IP吗?

可以。腾讯后台会根据请求中的appid判断是哪一个应用。

6. 第三方机器连接https服务器时报错:“...https: not supported!”

详细报错信息:“curl 1-libcurl was built with SSL disabled, https: not supported!”。
请注意如果是使用curl命令来连接https服务器,需要curl库编译时支持ssl。

7. 调用支付接口时报错:{"ret":-182,"msg":"app ip is invalid"}

-182属于系统内部错误。请通过企业QQ联系技术支持,调查问题原因并获得解决方案。

8. 购买的时候单位是Q点,支付和对账的时候单位是0.1Q点?

是的。
支付回调协议中,amt为支付总金额,以0.1Q点为单位。即如果总金额为4Q点,则amt的值是40。
对账的时候注意单位的转换。

9. 调用前台JS API,弹框出现“交易流水不存在”?

造成“交易流水不存在”的原因有2种:
1. Q点直购联调的2个步骤中用到的环境不一致,下面的2个步骤必须保持在同一环境:
(1)获取交易token(v3/pay/buy_goods);
(2)调用JS API展现页面(fusion2.dialog.buy )。
这2个步骤都涉及到正式环境和测试环境,必须都采用测试环境下的信息,或者都采用正式环境下的信息。不然就会出现“交易流水不存在”。

2. 交易token过期。
交易token的有效期是15分钟,过了15分钟后token失效,再调用支付页面时会出现流水号过期或者流水号不存在。

10. “SSL3_GET_SERVER_CERTIFICATE:certificate verify failed”?

该错误一般是由于hosting应用的发货服务器上设置了默认需要验证腾讯CPay证书造成的。 请改为不需要默认证书即可。
注意:对于non-hosting应用,则必须验证证书。


11. 调用支付接口时提示沙箱错误?

支付前台接口(除Q点充值和Q点查询接口外)联调时,都需要设置“sandbox”参数,以进入测试环境联调。
sandbox值为布尔型,true表示使用沙箱环境; false或不指定表示为正式环境。应用如果传入的是字符串,则会导致提示沙箱错误。

12. 调用前台JS接口时,param参数错误导致的问题?

(1)弹窗提示“fusion2.dialog.buy param not specified. ”
原因:param参数没传,或为空值。
(2)弹窗提示“fusion2.dialog.buy param not valid.”
原因:param参数存在非法字符,检测未通过。通常是param中有空格或其他非法字符之类的错误(参数param的值不允许出现除字母,数字, "_", "=", "/", "?", "&", "%", "-", "+"之外的字符)。
(3)支付界面空白或网页不存在等问题。
原因:通常是因为传错了param,导致调用弹窗的URL出错。请检查参数param的值是否有不完整、被截断之类的错误。

13. 为什么回调发货URL的amt参数是0?

回调发货url中表示金额的参数有三个,amt为Q点/Q币消耗金额或财付通游戏子账户的扣款金额,payamt_coins为扣取的游戏币总数,pubacct_payamt_coins为扣取的抵用券总金额,三者的合计才是扣款的总金额。如果amt为0,说明用户在支付中优先使用了抵扣券或者游戏币,未使用Q点/Q币或财付通游戏子账户的金额。

14.黄钻账号沙箱调试为什么没有打折?

检查pf是否为website,pf=website黄钻不打折,website是通过管理中心-应用总览-托管服务-分区登录中进入获得,需要从管理中心-应用管理-应用信息管理-平台信息-开发者权限调试地址进入调试,现网pf为qzone或者pengyou,不会出现pf=website。


支付审核相关

1.支付审核需要几个工作日?

提交日起,1-3个工作日内完成审核。

2.提交支付审核需要注意什么?

(1)确认货币名称和支付模式符合应用需求。
(2)确保沙箱环境下整个支付流程无异常。

3.支付审核那些内容?

(1)应用填写的信息是否符合规范。
(2)应用测试环境下支付各接口是否可用。

4.提交审核是否要修改沙箱为现网环境?

不需要。

5.提交审核后是否需要联系你们,把你们的QQ设置为调试者来测试功能?

不需要,开发商自己测试即可。

6.支付功能可否等应用上线后在开发?

可以,支付功能作为应用所有功能中的一个子集,建议先开发支付功能并联调通过,再提交应用上线审核。开发商根据实际情况自行决定。

7.应用提交上线申请是否需要修改支付环境为现网?

不需要,应用上线后才能使用现网环境。

8.提交应用上线申请,是否需要联系你们,把你们的QQ设置为调试者来测试功能?

不需要,应用上线申请属于商务审核范围,不需要联系支付技术支持。

9.支付审核必须跟黄钻功能同时上线?

是的,这里的上线是指支付和黄钻功能,如果要调试平台的营销活动,必须支付审核上线后才能调试。

10.应用发布后支付功能是否立即生效?

需要把支付沙箱环境修改为现网才能生效。

11.支付审核通过后是否可以在修改配置信息?

除了货币名称和支付模式外(支付模式为道具寄售),其他信息都可以修改。

12.支付审核通过后修改配置信息是否会再次审核?

不会审核,如果修改了发货配置信息,一定要同步环境后才能生效。

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

Copyright © 1998 - 2017 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部