全部
在线测试

应用场景

商户在调用微信支付提供的相关接口时,会得到微信支付返回的相关信息以及获得整个接口的响应时间。为提高整体的服务水平,协助商户一起提高服务质量,微信支付提供了相关接口调用耗时和返回信息的主动上报接口,微信支付可以根据商户侧上报的数据进一步优化网络部署,完善服务监控,和商户更好的协作为用户提供更好的业务体验。

接口地址

https://api.mch.weixin.qq.com/payitil/report

请求方式: POST

是否需要证书

不需要

输入参数

字段名 变量名 必填 类型 示例值 描述
公众账号 ID appid String(32) wx8888888888888888 微信分配的公众账号 ID(企业号 corpid 即为此 appId)
商户号 mch_id String(32) 1900000109 微信支付分配的商户号
设备号 device_info String(32) 013467007045764 微信支付分配的终端设备号,商户自定义
随机字符串 nonce_str String(32) 5K8264ILTKCH16CQ2502SI8ZNMTM67VS 随机字符串,不长于 32 位。推荐随机数生成算法
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名,详见签名生成算法
签名类型 sign_type String(32) HMAC-SHA256 签名类型,目前支持 HMAC-SHA256 和 MD5,默认为 MD5
接口 URL interface_url String(127) https://api.mch.weixin.qq.com/pay/unifiedorder 报对应的接口的完整 URL,类似:https://api.mch.weixin.qq.com/pay/unifiedorder对于刷卡支付,为更好的和商户共同分析一次业务行为的整体耗时情况,对于两种接入模式,请都在门店侧对一次刷卡支付进行一次单独的整体上报,上报 URL 指定为:https://api.mch.weixin.qq.com/pay/micropay/total关于两种接入模式具体可参考本文档章节:刷卡支付商户接入模式其它接口调用仍然按照调用一次,上报一次来进行。
接口耗时 execute_time_ Int 1000 接口耗时情况,单位为毫秒注意:该参数最后带有下划线“_”,参数设计如此,非文档问题。
返回状态码 return_code String(16) SUCCESS SUCCESS/FAIL 此字段是通信标识,非交易标识,交易是否成功需要查看 trade_state 来判断
返回信息 return_msg String(128) OK 当 return_code 为 FAIL 时返回信息为错误原因 ,例如签名失败参数格式校验错误
业务结果 result_code String(16) SUCCESS SUCCESS/FAIL
错误代码 err_code String(32) SYSTEMERROR ORDERNOTEXIST—订单不存在 SYSTEMERROR—系统错误
错误代码描述 err_code_des String(128) 系统错误 结果信息描述
商户订单号 out_trade_no String(32) 1217752501201407033233368018 商户系统内部的订单号,商户可以在上报时提供相关商户订单号方便微信支付更好的提高服务质量。
访问接口 IP user_ip String(16) 8.8.8.8 发起接口调用时的机器 IP
商户上报时间 time String(14) 20091227091010 系统时间,格式为 yyyyMMddHHmmss,如 2009 年 12 月 27 日 9 点 10 分 10 秒表示为 20091227091010。其他详见时间规则

返回结果

字段名 变量名 必填 类型 示例值 描述
返回状态码 return_code String(16) SUCCESS SUCCESS/FAIL 此字段是通信标识,非交易标识,交易是否成功需要查看 result_code 来判断
返回信息 return_msg String(128) 签名失败 返回信息,如非空,为错误原因签名失败参数格式校验错误

以下字段在 return_code 为 SUCCESS 的时候有返回

字段名 变量名 必填 类型 示例值 描述
业务结果 result_code String(16) SUCCESS SUCCESS/FAIL

错误码

有事情请找微信官方 谢谢!