对接后使用中常见问题,对号入座排查下。大部分为配置问题,亲们根据对接步骤目录的文档要耐心配置哦。

免签通道对接问题

顾客已经付款,订单状态显示“待支付、支付超时取消”等,未更新为已支付

常见原因:

  • 免签通道的收款APP收款后每笔必须要有通知栏收款提示,通知栏提示不是语音什么的,请参考教程里面的收款成功图示。请根据教程设置直到有通知栏收款通知
  • 监控APP和支付宝/微信等收款APP是否在同一个手机设备上使用。
  • 支付金额要与支付页面展示金额一致,请自行前往商户后台补单。
  • 监控APP的手机编号配置与收款码的手机编号要一致。
  • 订单已超时关闭后支付,请自行前往商户后台进行手动确认或补单。
  • 监控APP要保持运行页面状态。

间歇性异常排查参考如下步骤思路

  1. 查看收款后通知栏的到账通知是否有异常订单的通知(部分手机通知栏消息过多时候会不通知,请在无问题的正常使用阶段定期清空通知栏消息)。
  2. 查看监控app的该订单时段的监控日志。监控APP打开后需要有“监听服务开启成功”提示。
  3. 监控APP要保持前置页面,亮屏挂机。

支付接口返回无可用收款账号、支付页面无收款码、订单状态接单失败

常见原因:

  • 没有配置通用码,当同一个手机编号的所有固码都处于待支付状态会无码可用
  • 用户中心默认浮动范围设置为0
  • 未配置此收款方式的收款号
  • 对应收款方式的收款账号配置参数有误
  • 对应收款方式的收款账号未开通相应的支付产品

常见解决:

  • 增加对应支付方式的收款号,免签通道每个收款号可以配置通用码
  • 免签通道默认浮动范围不要设置0。每个收款号所有未支付订单数量累计21个(平台默认浮动-0.1~0.1)时候,将会无收款码可用,需要调整默认浮动范围
  • 增加携带自定义浮动的固码。
  • 签约通道请检查收款账号的参数设置,以及是否开通了相应的支付产品

监控APP日志显示“监控回调失败”

此提示并非标志监控APP出现异常了,这是正常的错误提示,出现此提示原因如下:

  • 顾客实际支付金额与创建的订单金额不一致,多出现于通用码顾客二次输入金额与页面展示不一致
    解决方法:商户可以商户后台对照收款时间找到对应订单进行手动补单操作
  • 订单已经过期,顾客才支付
    解决方法:商户可以商户后台对照收款时间找到对应订单进行手动确认支付
  • 监控app的手机编号配置与收款码的手机编号配置不一致 解决方法:收款码的手机编号配置与所在手机的监控app的手机编号配置一致
  • 其他通知异常需查看具体返回原因

终端客户实际支付完成,但此时订单已经超时了,如何解决?

进入商户后台→商户订单,点开对应的订单前面的+,点击确认支付。

免签通道顾客实际支付完成,但支付金额与支付页面金额不一致,如何解决?

进入商户后台→商户订单,点开对应的订单前面的+,点击补单,输入客户实际支付金额。A:进入商户后台→商户订单,点开对应的订单前面的+,点击补单,输入客户实际支付金额。

支付宝拉起后提示不支持此种方式

对于免签通道,我们会尝试拉起支付客户端让顾客进行支付。如果频繁启动,支付宝会对客户端限制这种操作,这种顾客就只能截图扫码。免签的我们会尽可能做的让顾客更好用,但是终究是免签。
对接使用问题 - 图1

动态码、支付宝转账银行卡等扫码后支付宝APP提示“已停止访问该网页”

有的顾客截图识别会有一定概率出现“已停止访问该网页”,可以结束支付宝进程重新打开识别截图或者直接扫一扫尝试。一般情况下多数是因为顾客手机多次操作频繁识别此类二维码,支付宝会对客户端限制这种操作,免签的我们会尽可能做的让顾客更好用,但是终究是免签。
对接使用问题 - 图2

签约通道对接问题

不能正常支付/接单失败

当面付/Native方式不展示二维码

通用问题

商户订单的订单状态已支付,但回调结果异常

顾客支付完成后(订单状态为“已支付”),支付FM把相关支付结果和相关信息发送给商户的业务系统,商户系统需要接收处理该消息,并返回应答。
如果支付FM收到商户的业务系统应答超时或者不是返回success,支付FM认为通知异常,支付FM会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。(首次实时通知异常后重发通知频率为15s/30s/3m/10m/20m/30m/60m/3h/6h/ - 总计 11h3m45s)

  1. 首先确认异步回调地址的域名是否为公网可访问
  2. 其次可以把业务代码注释直接返回success,如通知成功则标识异步地址是通的
  3. 请在接收异步通知地址对应的函数内打印日志查看是否收到参数。如果收到参数请检查业务代码执行过程是否出现问题导致没有返回success
  4. notifyUrl主要用于业务系统更新订单状态,其他复杂业务逻辑建议异步执行,防止业务逻辑执行时间过长而出现的请求超时导致未收到返回的success
  5. 如果您的业务代码正常执行完了,请记得返回success这个字符串给我们。

无后台前端代码请求跨域问题

  1. 前台不要通过ajax方式直接请求接口
  2. 通过nginx反向代理解决,可以参考如下文章:
  1. https://blog.csdn.net/l1028386804/article/details/79488328?utm_medium=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.channel_param&depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromMachineLearnPai2-1.channel_param