交易保障

更新时间:2024.11.13

应用场景

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

接口地址

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

是否需要证书

不需要

输入参数

字段名

变量名

必填

类型

示例值

描述

公众账号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

此字段是通信标识,非交易标识,交易是否成功需要查看trade_state来判断

返回信息

return_msg

String(128)

OK

当return_code为FAIL时返回信息为错误原因 ,例如:签名失败、参数格式校验错误

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

字段名

变量名

必填

类型

示例值

描述

业务结果

result_code

String(16)

SUCCESS

SUCCESS/FAIL

错误码

 

反馈
咨询
目录
置顶