接口类常见问题排查指南

大约 3 分钟

接口类常见问题排查指南

本文主要为互联开放平台开发遇到的相关问题提供解决思路,帮助您加速定位及解决问题。

常见问题排查

1、若接口返回有相关错误码,可到响应码对照定位问题原因。

2、支付通知无法收到,请确定实际的应用网关地址与在互联开放平台中配置的应用网关地址一致,应用网关目前需要配置白名单维护,可能存在生效的时间差。

3、微信支付提示当前商户需要补齐相关资料,这是因为微信商户需要认证。

4、订单查询,退款查询报权限不足,是因为生产环境中,该 API 版本为 1.0.1,其余 API 版本为 1.0.0,需要做区分。

5、当天对账单无法现在,是因为我们目前的对账单是 T+1 生成的。

6、开放平台提示暂无权限注册,是因为未维护用户白名单,请联系相关人员维护白名单。

7、签名怎么生成,请参考开发指南中签名验签部分。

8、目前一个应用对应一个应用网关地址,无法配置多个应用网关地址。

9、日累计交易金额校验失败,是因为支付宝微信的退款逻辑为扣除当天的交易金额作为退款,若当天没有交易或交易金额不足以退款,则无法退款。

10、目前支付结果通知和退款结果通知都为一个通知地址,不支持分离通知,可以通过报文内容或流水号区分。

支付类

Q:报错提示当前时间段不支持微信,支付宝,银联的退款交易。

A:每日凌晨 12:00 左右为日切阶段,该阶段不支持相关交易。


Q:请求返回交易过期或交易超时。

A:返回交易过期或交易超时一般原因都是三方请求服务器时间未校准为北京时间,导致通信传递的时间戳非标准北京时间。


Q:退款交易返回成功了但是没有收到钱。

A:退款分为两步,三方发起退款申请,我们异步处理退款信息成功后异步通知三方。退款申请成功并不代表退款交易成功,需通过退款查询接口查询退款交易状态或通过对接退款异步通知来获取退款交易状态。


Q:退款申请成功了,但是退款失败了,返回累积校验金额失败。

A:目前采用的退款逻辑为,各渠道当日的退款金额从当日的入账金额中扣除,退款需保证对应渠道当日入账大于退款。


Q:支付报商户信息不存在

A:1.确认相关商户信息,如商户识别号上送正确。


Q:对账单下载失败

A:目前对账单的下载链接设置为 30s 左右,超时后无法下载。对账单保留 3 个月。


Q:请求报重报检查失败

A:每次请求 nonce 需要唯一不重复。


Q:对账单获取参数异常,异常码-1

A:可能由于支付请求上送租户号与商户进件时传入商户号不一致,导致对账单生成异常。


Q:下单账号与支付账号不一致,请核实后再支付。

A:测试环境需绑定相关微信账号才能完成支付。


Q:微信线上下单失败:sub_much_id 与 sub_appid 不匹配。

A:测试环境需绑定相关信息才能完成支付。


Q:使用 sdk,请求正产返回,但是签名校验为 false。

A:未使用正确的开放平台公钥验签。