查询企业付款

用于商户的企业付款操作进行结果查询,返回付款操作详细结果。查询企业付款API只支持查询30天内的订单,30天之前的订单请登录商户平台查询。

简介

用于商户的企业付款操作进行结果查询,返回付款操作详细结果。

查询企业付款API只支持查询30天内的订单,30天之前的订单请登录商户平台查询。

注意事项

◆ 如果查询单号对应的数据不存在,那么数据不存在的原因可能是:(1)付款还在处理中;(2)付款处理失败导致付款订单没有落地。在上述情况下,商户首先需要检查该商户订单号是否确实是自己发起的,如果商户确认是自己发起的,则请商户不要直接当做付款失败处理,请商户隔几分钟再尝试查询(请勿付款和查询并发处理),或者商户可以通过相同的商户订单号再次发起付款。如果商户误把还在付款处理中的订单直接当付款失败处理,商户应当自行承担因此产生的所有损失和责任。

◆ XML具有可扩展性,因此返回参数可能会有新增,而且顺序可能不完全遵循此文档规范,如果在解析回包的时候发生错误,请商户务必不要换单重试,请商户联系客服确认付款情况。如果有新回包字段,会更新到此API文档中。

◆ 因为错误代码字段err_code的值后续可能会增加,所以商户如果遇到回包返回新的错误码,请商户务必不要换单重试,请商户联系客服确认付款情况。如果有新的错误码,会更新到此API文档中。

◆ 错误代码描述字段err_code_des只供人工定位问题时做参考,系统实现时请不要依赖这个字段来做自动化处理。

接口调用请求说明

请求Url https://api.mch.weixin.qq.com/mmpaymkttransfers/gettransferinfo
是否需要证书 是(证书及使用说明详见商户证书
请求方式 POST
接口调用频率限制 30/s

请求参数

字段名 字段 必填 示例值 类型 说明
随机字符串 nonce_str 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串,不长于32位
签名 sign C380BEC2BFD727A4B6845133519F3AD6 String(32) 生成签名方式查看3.2.1节
商户订单号 partner_trade_no 10000098201411111234567890 String(32) 商户调用企业付款API时使用的商户订单号
商户号 mch_id 10000098 String(32) 微信支付分配的商户号
Appid appid wxe062425f740d30d8 String(128) 商户号的appid

数据示例:

<xml>

<sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>

<partner_trade_no><![CDATA[0010010404201411170000046545]]></partner_trade_no>

<mch_id ><![CDATA[10000097]]></mch_id >

<appid><![CDATA[wxe062425f740c30d8]]></appid>

<nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>

</xml>

返回参数

字段名 变量名 必填 示例值 类型 说明
返回状态码 return_code SUCCESS String(16) SUCCESS/FAIL

此字段是通信标识,非付款标识,付款是否成功需要查看result_code来判断

返回信息return_msg签名失败String(128)返回信息,如非空,为错误原因

签名失败

参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回
业务结果result_codeSUCCESSString(16)SUCCESS/FAIL ,非付款标识,付款是否成功需要查看status字段来判断
错误代码err_codeSYSTEMERRORString(32)错误码信息
错误代码描述err_code_des系统错误String(128)结果信息描述
以下字段在return_code 和result_code都为SUCCESS的时候有返回
商户单号partner_trade_no10000098201411111234567890String(32)商户使用查询API填写的单号的原路返回.
Appidappidwxe062425f740d30d8String(128)商户号的appid
商户号mch_id10000098String(32)微信支付分配的商户号
付款单号detail_id1000000000201503283103439304String(64)调用企业付款API时,微信系统内部产生的单号
转账状态statusSUCCESSstring(16)SUCCESS:转账成功

FAILED:转账失败

PROCESSING:处理中

失败原因reason余额不足String(128)如果失败则有失败原因
收款用户openidopenidoxTWIuGaIt6gTKsQRLau2M0yL16EString(64)转账的openid
收款用户姓名transfer_name马华String(64)收款用户姓名
付款金额payment_amount5000int付款金额单位为“分”
转账时间transfer_time2015-04-21 20:00:00String(32)发起转账的时间
付款成功时间payment_time2015-04-21 20:01:00String(32)企业付款成功时间
企业付款备注desc车险理赔String(100)企业付款备注

示例:

<xml> // 按照格式补充

<return_code><![CDATA[SUCCESS]]></return_code>

<return_msg><![CDATA[获取成功]]></return_msg>

<result_code><![CDATA[SUCCESS]]></result_code>

<mch_id>10000098</mch_id>

<appid><![CDATA[wxe062425f740c30d8]]></appid>

<detail_id><![CDATA[1000000000201503283103439304]]></detail_id>

<partner_trade_no><![CDATA[1000005901201407261446939628]]></partner_trade_no>

<status><![CDATA[SUCCESS]]></status>

<payment_amount>650</payment_amount >

<openid ><![CDATA[oxTWIuGaIt6gTKsQRLau2M0yL16E]]></openid>

<transfer_time><![CDATA[2015-04-21 20:00:00]]></transfer_time>

<transfer_name ><![CDATA[测试]]></transfer_name >

<desc><![CDATA[福利测试]]></desc>

</xml>

错误码

错误代码 描述 解决方案
CA_ERROR 请求未携带证书,或请求携带的证书出错 到商户平台下载证书,请求带上证书后重试
SIGN_ERROR 商户签名错误 按文档要求重新生成签名后再重试
FREQ_LIMIT 受频率限制 请对请求做频率控制
XML_ERROR 请求的xml格式错误,或者post的数据为空 检查请求串,确认无误后重试
PARAM_ERROR 参数错误 请查看err_code_des,修改设置错误的参数
SYSTEMERROR 系统繁忙,请再试 系统繁忙
NOT_FOUND 1、指定单号数据不存在 2、指定单号数据不存在,单据查询超过有效期 1、查询单号对应的数据不存在,请使用正确的商户订单号查询

2、如需查询超过有效期的单据,请登录到商户平台进行查询

本文来自投稿,不代表微擎百科立场,如若转载,请注明出处:https://www.w7.wiki/operation/2784.html

发表评论

登录后才能评论