常见问题

商户入驻汇总

1）为何要实名认证？
根据《中华人民共和国网络安全法》第二十四条规定，必须要求提供实名信息。在涉及账号归属问题时，实名信息可以有效的确定所有者。

2）为什么实名认证还没通过？ 实名认证由系统自动审核+人工辅助审核。若商户处于待审核状态，可能是证件图片模糊无效，或与提交认证的信息不一致，导致系统判断失败进入人工审核阶段。若有需求，可联系在线客服申请加急处理实名认证审核。

3）如何获取密钥？
-- 测试环境获取参数：测试环境模拟数据
-- 正式环境获取路径：API服务-应用管理-密钥管理-获取参数（备注：显示密钥需要验证主账号手机号短信验证码获取）

4）无效的AppKey，如何处理？
错误原因：
接口请求时服务器会校验请求参数的app_key，判断当前app_key是否有效；
解决方案：
检查app_key是否复制错误；
测试环境与生产环境数据不互通；
测试环境只能使用沙箱数据，测试环境数据获取地址：测试环境模拟数据；

5）签名问题
按以下点排查：

看对接环境是否搞错，是否有测试环境与生产环境交叉用错情况；

看参与签名参数值是否原值非编码；

看参数名称和参数值是否输写错误；

参数值null要做为字符串参与签名；

接口请求签名、接口响应签名、异步回调签名的规则都是一样的，可参考签名规则；

接口响应中的签名，是使用响应参数result的值做的签名，规则是将该值字符串转成字符数组，然后排序该字符数组，再将该字符数组中的元素拼接成字符串，在它后面带上秘钥，最后md5。
备注：一般是null没有做为字符串参与签名，请自行排查代码。

商品汇总

商品模板汇总

1）什么场景使用商品模板？
直充商品必须对接商品模板接口，卡密商品无需对接商品模板接口。

2）如何使用商品模板？
通过商品编号，调用“获取商品信息接口”，得到商品模板编号，通过商品模板编号，调用“获取商品模板接口”，即可得到商品模板信息；具体可参考商品模版指引说明；
商品模板是json格式字符串，可渲染到前端，让用户充值时，自行选择游戏区服、充值方式等信息。

3）商品模板中区和服下面都有ChargeServer和ChargeType，以哪个为准？
商品模板里区服联动的情况，如果区下级有服，那么与区同级的服一定没值；如果与区同级的服有值的话，那么区下级的服也一定没值；区服联动关系里，以有值的节点为准。

4）模板返回多个游戏区服信息，如何区分商品对应的是哪个游戏？
商品的区服模版解析后，若有多个游戏，说明该商品编号可适应多个游戏的区服信息；则可解析出对应游戏的区服信息；或把所有游戏都解析出来，由用户选择充值哪个游戏。

5）区服信息以哪个为准？
isServiceArea=false，表明没有区服信息，但gameTemplatePreviewList显示有区服信息；目前isServiceArea是保留字段可以不用关注，以gameTemplatePreviewList显示的有区服信息的为准。

商品信息汇总

1）商品不存在
可按照以下点排查问题：

运营检查商品配置（包括：商户是否审核、充值API应用是否申请及审核、充值API应用是否密价了商品、平台商品是否上架、平台商品是否标识删除、sup商品是否下架）；
是否搞错对接环境，测试环境与正式环境不通用；
如果一个用户存在多个商户情况，请与福禄运营确认这些商户对接的商品是否都配置正常。

2）商品状态异常如何处理？
接口下单时，商品状态异常（如：下架/维护中/库存不足等），出现此问题，请联系福禄运营检查生产环境商品配置，如有活动需要大数量商品请向福禄运营提前报备。

3）商品信息变动回调如何使用？

使用场景：
当平台商品状态发生变更：上架、下架(库存维护、官方维护、商品下架)以及商品价格调整时，会将变更结果主动通知至商户配置的“商品变更回调地址”上；

配置流程：
回调地址配置入口为：福禄开放平台->API服务->应用管理->参数配置；

回调接口接入文档：商品信息变动回调

4）下单返回商品类型错误，如何处理？

产生问题：
当下单返回“code=3008,message=商品类型错误”；

原因和解决方案：
直充下单接口或卡密下单接口中，用直充下单接口下了卡密商品，或用卡密下单接口下了直充商品，就会返回商品类型错误，请使用正确类型的商品下单。

5）卡密商品解密问题

卡密解密参考文档：卡密解密说明

java开发语言，需要第三方依赖： commons-codec-1.11.jar、gson-2.8.5.jar、bcprov-jdk15on.jar；

卡密解密中对于强加密长度超过128的，需要替换jre/lib/security下两个jar包“ocal_policy.jar ”和“US_export_policy.jar”下载及参考文档：https://blog.csdn.net/tomatocc/article/details/85096911 。

6）接口中能获取到商品主图吗？
API接口中能回传商品图标，不能回传商品主图，可线下找运营提供。

充值汇总

1）直充下单充值账号是手机号吗？
不一定是填手机号，有邮箱或其他信息；具体填什么由具体的商品决定。

2）充值账号填错了如何处理？
由于充值账号填错，订单充值成功而造成的损失由合作方自行承担；订单充值失败不会扣款；接口不提供对充值账号的校验能力，可由需求方根据商品情况，在自己的业务侧进行校验；只要充值账号参数有值，就会下单充值，基于上游返回最终结果。

3）同一个号码能限次充值吗？
标准接口不会做此限制，需业务方自行限制。

4）接口返回找不到手机号问题，如何处理?
此问题主要针对话费下单接口或者手机号归属地接口，可联系福禄运营将该手机号添加到福禄手机号归属地数据库中；备注：虚拟号段充值，福禄暂不支持。

5）充值失败是否可重试？

请求接口失败（错误码非：4008、4009、4010、4012、5000），可进行原订单号重试；

如果接口请求成功订单状态失败（即：order_state=failed），则代表该订单最终状态为失败，不能原单重试，需要重新下单。

6）话费充值失败问题
烦请按照以下原因排查：

当天同一号码同时提交5次进入黑名单，超过5次则充值失败（全渠道限5次）；

特殊手机号码无法充值：

充值号码是空号或携号转网；

话费按月出账单，根据账单后付费用户（广东联通智能网用户186等号段）；

铁通、小灵通等充值号码、寻呼机号码（中国电信191等号段）；

虚拟运营商号段（170、171、175、179、165等号段）。

7）话费下单有无商品编号？

普通话费下单接口中没有商品编号，接口会根据充值手机号、充值面值（具体能充值的面值可与福禄运营沟通）自动匹配充值商品；

三网通商品需要使用直充下单接口下单，需要商品编号。

异步回调汇总

1）如何测试异步回调？
在线上接口文档中："异步回调测试"中可测试你的回调接口是否能正常收到回调消息。

2）卡密异步回调问题
卡密回调通知中不会有卡密信息，只用来同步订单状态；当订单有了最终充值结果：成功或失败的时候，才会发起异步通知；要获得卡密信息，只能通过订单查询接口来获取；当异步通知订单成功后，此时可以再调用订单查询接口来获得卡密。

3）回调有IP限制吗？
我方回调通知没有ip限制；只要配置了回调地址，当订单有了最终充值结果：success或failed，都会发送回调消息；如果回调给你消息后，你不是返回的正常响应，则会再重试两次回调，第二次在首次发送后间隔3分钟，第三次在第二次发送后间隔5分钟。

4）下单成功间隔多久会回调我们？
订单有了最终充值结果：success或failed，会立即发起回调通知；但是订单多久有充值结果，这个不确定；目前正常情况是1至3秒就会有充值结果。

5）卡密下单后，回调通知充值失败
这是正常情况；充值失败的后续业务流程由合作方自行设计和控制，我们接口不会对充值失败的卡密订单自动补充，充值失败就是这笔订单的完结状态。

6）异步通知服务器及出口IP地址是什么？
请点击查看测试环境模拟数据

订单汇总

1）如何获取对账单

方式①：可以登录商户控制台下载对账单；

方式②：可直接对接对账单申请接口以对账单通知回调接口来获取。

2）订单什么情况下返回处理中？
未处理和处理中可以都当处理中处理；下单成功，就是订单状态未处理；下单成功不代表充值成功，充值是有一个过程的，我们接口是异步的，需要调用订单查询接口来同步订单状态。所以调用订单查询接口的时候会有未处理、处理中状态。

3）订单查询接口根据什么判断充值结果？
根据order_state这个字段判断充值结果，success表示充值成功，failed表示充值失败。

4）没有收到回调怎么办？
若没有收到回调，可通过手工重推的方式来同步订单状态，在商户控制台->API服务->应用管理->参数配置->订单回调地址->推送这里给没有收到回调的订单手工发起回调，即可自动完成流程。
同时，您这边是否有对接订单查询接口？如没对接而仅仅依赖被动回调，当回调出现异常时就会出现订单状态不能同步的问题，而订单查询接口在订单充值业务是必须要对接的接口，当回调异常时，通过主动订单查询是能同步订单状态。

商户入驻汇总#

商品汇总#

商品模板汇总#

商品信息汇总#

充值汇总#

异步回调汇总#