对接后使用中常见问题,对号入座排查下。大部分为配置问题,亲们根据对接步骤目录的文档要耐心配置哦。
免签类型对接问题
顾客已经付款,接口订单状态显示“待支付、支付超时取消”等,未更新为已支付
顾客已经付款,支付链接不跳转
常见原因:
- 免签类型的收款APP收款后每笔必须要有
通知栏收款提示
,通知栏提示不是语音什么的,请参考教程里面的收款成功图示。请根据教程设置直到有通知栏收款通知。- 监控APP和支付宝/微信等收款APP是否在同一个手机设备上使用。
- 支付金额要与支付页面展示金额一致,请自行前往商户后台补单。
- 监控APP的手机编号配置与收款码的手机编号要一致。
- 订单已超时关闭后支付,请自行前往商户后台进行手动确认或补单。
- 监控APP要保持运行页面状态。
间歇性异常排查参考如下步骤思路
- 查看收款后通知栏的到账通知是否有异常订单的通知(部分手机通知栏消息过多时候会不通知,请在无问题的正常使用阶段定期清空通知栏消息)。
- 查看监控app的该订单时段的监控日志。监控APP打开后需要有“监听服务开启成功”提示。
- 监控APP要保持前置页面,亮屏挂机。
支付接口返回无可用收款账号、支付页面无收款码、订单状态接单失败
常见原因:
- 没有配置通用码,当同一个手机编号的所有固码都处于待支付状态会无码可用
- 用户中心默认浮动范围设置为0
- 未配置此收款方式的收款号
- 对应收款方式的收款账号配置参数有误
- 对应收款方式的收款账号未开通相应的支付产品
常见解决:
监控APP日志显示“监控回调失败”
此提示并非标志监控APP出现异常了,这是正常的错误提示,出现此提示原因如下:
- 顾客实际支付金额与创建的订单金额不一致,多出现于通用码顾客二次输入金额与页面展示不一致
解决方法:商户可以商户后台对照收款时间找到对应订单进行手动补单操作- 订单已经过期,顾客才支付
解决方法:商户可以商户后台对照收款时间找到对应订单进行手动确认支付- 监控app的手机编号配置与收款码的手机编号配置不一致 解决方法:收款码的手机编号配置与所在手机的监控app的手机编号配置一致
- 其他通知异常需查看具体返回原因
终端客户实际支付完成,但此时订单已经超时了,如何解决?
进入商户后台→商户订单,点开对应的订单前面的+,点击确认支付。
免签类型顾客实际支付完成,但支付金额与支付页面金额不一致,如何解决?
进入商户后台→商户订单,点开对应的订单前面的+,点击补单,输入客户实际支付金额。A:进入商户后台→商户订单,点开对应的订单前面的+,点击补单,输入客户实际支付金额。
支付宝拉起后提示不支持此种方式
对于免签类型,我们会尝试拉起支付客户端让顾客进行支付。如果频繁启动,支付宝会对客户端限制这种操作,这种顾客就只能截图扫码。免签的我们会尽可能做的让顾客更好用,但是终究是免签。
![]()
动态码、支付宝转账银行卡等扫码后支付宝APP提示“已停止访问该网页”
有的顾客截图识别会有一定概率出现“已停止访问该网页”,可以结束支付宝进程重新打开识别截图或者直接扫一扫尝试。一般情况下多数是因为顾客手机多次操作频繁识别此类二维码,支付宝会对客户端限制这种操作,免签的我们会尽可能做的让顾客更好用,但是终究是免签。
签约类型对接问题
不能正常支付/接单失败
- 请检查是否开通签约产品
支付宝商户签约产品地址:https://b.alipay.com/signing/productSetV2.htm
微信支付商户产品地址:https://pay.weixin.qq.com/index.php/extend/product/lists?tid=3- 检查密钥配置是否正确
支付宝的RSA2密钥一定要选择java适用的,一定要仔细看教程配置
微信支付的密钥pem文件直接文本打开全选复制,不要修改格式- 看不出来问题请联系客服
当面付/Native方式不展示二维码
- 请检查是否开通支签约产品
支付宝商户签约产品地址:https://b.alipay.com/signing/productSetV2.htm
微信支付商户产品地址:https://pay.weixin.qq.com/index.php/extend/product/lists?tid=3- 检查公钥、私钥配置是否正确
支付宝的RSA2密钥一定要选择java适用的,一定要仔细看教程配置
微信支付的密钥pem文件直接文本打开全选复制,不要修改格式- 看不出来问题请联系客服
通用问题
商户订单的订单状态已支付,但回调结果异常
顾客支付完成后(订单状态为“已支付”),支付FM把相关支付结果和相关信息发送给商户的业务系统,商户系统需要接收处理该消息,并返回应答。
如果支付FM收到商户的业务系统应答超时或者不是返回success,支付FM认为通知异常,支付FM会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。(首次实时通知异常后重发通知频率为15s/30s/3m/10m/20m/30m/60m/3h/6h/ - 总计 11h3m45s)
- 首先确认异步回调地址的域名是否为公网可访问
- 其次可以把业务代码注释直接返回success,如通知成功则标识异步地址是通的
- 请在接收异步通知地址对应的函数内打印日志查看是否收到参数。如果收到参数请检查业务代码执行过程是否出现问题导致没有返回success
- notifyUrl主要用于业务系统更新订单状态,其他复杂业务逻辑建议异步执行,防止业务逻辑执行时间过长而出现的请求超时导致未收到返回的success
- 如果您的业务代码正常执行完了,请记得返回success这个字符串给我们。
无后台前端代码请求跨域问题
- 前台不要通过ajax方式直接请求接口
- 通过nginx反向代理解决,可以参考如下文章:
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
“您即将提交的信息不安全由于系统正在使用不安全的连接提交此表单,他人将能看到您的信息。”
接口地址使用https开头的地址进行请求。