查询付款
更新时间:2024.11.13简介
用于商户的付款操作进行结果查询,返回付款操作详细结果。
查询付款API只支持查询30天内的订单,30天之前的订单请登录商户平台查询。
|
接口调用请求说明
请求Url | https://api.mch.weixin.qq.com/mmpaymkttransfers/gettransferinfo |
---|---|
是否需要证书 | 是(证书及使用说明详见商户证书) |
请求方式 | POST |
签名方式 | MD5 |
接口调用频率限制 | 30/s |
请求参数
字段名 | 字段 | 必填 | 示例值 | 类型 | 说明 |
---|---|---|---|---|---|
随机字符串 | nonce_str | 是 | 5K8264ILTKCH16CQ2502SI8ZNMTM67VS | String(32) | 随机字符串,不长于32位 |
签名 | sign | 是 | C380BEC2BFD727A4B6845133519F3AD6 | String(32) | 签名,详见签名算法 |
商户订单号 | partner_trade_no | 是 | 10000098201411111234567890 | String(32) | 商户调用付款API时使用的商户订单号 |
商户号 | mch_id | 是 | 10000098 | String(32) | 微信支付分配的商户号 |
Appid | appid | 是 | wxe062425f740d30d8 | String(128) | 商户号的appid |
数据示例:
返回参数
字段名 | 变量名 | 必填 | 示例值 | 类型 | 说明 |
---|---|---|---|---|---|
返回状态码 | return_code | 是 | SUCCESS | String(16) | SUCCESS/FAIL 此字段是通信标识,非付款标识,付款是否成功需要查看result_code来判断 |
返回信息 | return_msg | 否 | 签名失败 | String(128) | 返回信息,如非空,为错误原因 签名失败 参数格式校验错误 |
以下字段在return_code为SUCCESS的时候有返回 | |||||
业务结果 | result_code | 是 | SUCCESS | String(16) | SUCCESS/FAIL ,非付款标识,付款是否成功需要查看status字段来判断 |
错误代码 | err_code | 否 | SYSTEMERROR | String(32) | 错误码信息 |
错误代码描述 | err_code_des | 否 | 系统错误 | String(128) | 结果信息描述 |
以下字段在return_code 和result_code都为SUCCESS的时候有返回 | |||||
商户单号 | partner_trade_no | 是 | 10000098201411111234567890 | String(32) | 商户使用查询API填写的单号的原路返回. |
Appid | appid | 是 | wxe062425f740d30d8 | String(128) | 商户号的appid |
商户号 | mch_id | 是 | 10000098 | String(32) | 微信支付分配的商户号 |
付款单号 | detail_id | 是 | 1000000000201503283103439304 | String(64) | 调用付款API时,微信支付系统内部产生的单号 |
转账状态 | status | 是 | SUCCESS | string(16) | SUCCESS:转账成功 FAILED:转账失败 PROCESSING:处理中 |
失败原因 | reason | 否 | 余额不足 | String(128) | 如果失败则有失败原因 |
收款用户openid | openid | 是 | oxTWIuGaIt6gTKsQRLau2M0yL16E | String(64) | 转账的openid |
收款用户姓名 | transfer_name | 否 | 马华 | String(64) | 收款用户姓名 |
付款金额 | payment_amount | 是 | 5000 | int | 付款金额单位为“分” |
转账时间 | transfer_time | 是 | 2015-04-21 20:00:00 | String(32) | 发起转账的时间 |
付款成功时间 | payment_time | 是 | 2015-04-21 20:01:00 | String(32) | 付款成功时间 |
付款备注 | desc | 是 | 车险理赔 | String(100) | 付款备注 |
示例:
错误码
错误代码 | 描述 | 解决方案 |
---|---|---|
CA_ERROR | 请求未携带证书,或请求携带的证书出错 | 到商户平台下载证书,请求带上证书后重试 |
SIGN_ERROR | 商户签名错误 | 按文档要求重新生成签名后再重试 |
FREQ_LIMIT | 受频率限制 | 请对请求做频率控制 |
XML_ERROR | 请求的xml格式错误,或者post的数据为空 | 检查请求串,确认无误后重试 |
PARAM_ERROR | 参数错误 | 请查看err_code_des,修改设置错误的参数 |
SYSTEMERROR | 系统繁忙,请再试 | 系统繁忙 |
NOT_FOUND | 1、指定单号数据不存在 2、指定单号数据不存在,单据查询超过有效期 | 1、查询单号对应的数据不存在,请使用正确的商户订单号查询 2、如需查询超过有效期的单据,请登录到商户平台进行查询 |