最新更新时间：2020.5.08 版本说明
商户在调用微信支付提供的相关接口时，会得到微信支付返回的相关信息以及获得整个接口的响应时间。为提高整体的服务水平，协助商户一起提高服务质量，微信支付提供了相关接口调用耗时和返回信息的主动上报接口，微信支付可以根据商户侧上报的数据进一步优化网络部署，完善服务监控，和商户更好的协作为用户提供更好的业务体验。
适用对象:机构模式
请求URL:https://api.mch.weixin.qq.com/payitil/report
请求方式: POST
是否需要证书: 否
| 参数名 | 变量名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 公众账号ID | appid | string(32) | 是 | 微信分配的公众账号ID 示例值：wx8888888888888888 |
| 商户号 | mch_id | string(32) | 是 | 微信支付分配的商户号 示例值：1900000109 |
| 子商户公众账号ID | sub_appid | string(32) | 是 | 微信分配的子商户公众账号ID 示例值：wx8888888888888888 |
| 子商户号 | sub_mch_id | string(32) | 是 | 微信支付分配的子商户号 示例值：1900000109 |
| 设备号 | device_info | string(32) | 否 | 微信支付分配的终端设备号，商户自定义 示例值：013467007045764 |
| 随机字符串 | nonce_str | string(32) | 是 | 随机字符串，不长于32位。推荐随机数生成算法 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 签名 | sign | string(64) | 是 | 签名，详见签名生成算法 示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS |
| 签名类型 | sign_type | string(32) | 否 | 签名类型，目前支持HMAC-SHA256和MD5，默认为MD5 示例值：HMAC-SHA256 |
| 接口URL | interface_url | string(127) | 是 |
上报对应的接口的完整URL，类似： https://api.mch.weixin.qq.com/pay/unifiedorder 对于刷卡支付，为更好的和商户共同分析一次业务行为的整体耗时情况，对于两种接入模式，请都在门店侧对一次刷卡行为进行一次单独的整体上报，上报URL指定为： https://api.mch.weixin.qq.com/pay/micropay/total 关于两种接入模式具体可参考本文档章节：刷卡支付商户接入模式 其它接口调用仍然按照调用一次，上报一次来进行。 示例值：https://api.mch.weixin.qq.com/pay/unifiedorder |
| 接口耗时 | execute_time_ | int | 是 | 接口耗时情况，单位为毫秒 示例值：1000 |
| 返回状态码 | return_code | string(16) | 是 |
SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看trade_state来判断 示例值：SUCCESS |
| 返回信息 | return_msg | string(128) | 否 |
返回信息，如非空，为错误原因 签名失败 参数格式校验错误 示例值：签名失败 |
| 业务结果 | result_code | string(16) | 是 |
SUCCESS/FAIL 示例值：SUCCESS |
| 错误代码 | err_code | string(32) | 否 |
ORDERNOTEXIST—订单不存在 SYSTEMERROR—系统错误 示例值：SYSTEMERROR |
| 错误代码描述 | err_code_des | string(128) | 否 |
结果信息描述 示例值：系统错误 |
| 商户订单号 | out_trade_no | string(32) | 否 |
商户可以在上报时提供相关商户订单号方便微信支付更好的提高服务质量。 示例值：1217752501201407033233368018 |
| 访问接口IP | user_ip | string(16) | 是 |
发起接口调用时的机器IP 示例值：8.8.8.8 |
| 户上报时间 | time | string(14) | 否 |
系统时间，格式为yyyyMMddHHmmss，如2009年12月27日9点10分10秒表示为20091227091010。其他详见时间规则 示例值：20091227091010 |
| 字段名 | 变量名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 返回状态码 | return_code | string(16) | 是 | SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断 示例值：SUCCESS |
| 返回信息 | return_msg | string(128) | 否 | 返回信息，如非空，为错误原因 签名失败 参数格式校验错误 示例值：签名失败 |
以下字段在return_code为SUCCESS的时候有返回
| 字段名 | 变量名 | 类型 | 必填 | 描述 |
|---|---|---|---|---|
| 业务结果 | result_code | string(16) | 是 | SUCCESS/FAIL 示例值：SUCCESS |
无
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证