基础支付
JSAPI支付
APP支付
H5支付
Native支付
小程序支付
合单支付
付款码支付
经营能力
微信支付分(公共API)
微信支付分(免确认预授权模式)
微信支付分(需确认模式)
支付即服务
行业方案
智慧商圈
微信支付分停车服务
电子发票
营销工具
代金券
商家券
委托营销
支付有礼
小程序发券插件
H5发券
图片上传(营销专用)
现金红包
资金应用
商家转账到零钱
分账
风险合规
消费者投诉2.0
其他能力
清关报关
图片上传
视频上传
微信支付平台证书

转账电子回单申请受理API

最新更新时间:2021.10.26 版本说明


转账电子回单申请受理接口,商户通过该接口可以申请受理电子回单服务。

注意:

• 发起转账时传入了收款用户姓名,支持申请电子回单;

• 支持受理最近30天内的转账明批次单;

• 仅支持已完成状态且至少一笔成功记录的批次获取电子回单(不满足条件返回:400 INVALID_REQUEST);

接口说明

适用对象:直连商户

请求URL:https://api.mch.weixin.qq.com/v3/transfer/bill-receipt

请求方式:POST

接口限频: 单个商户 20QPS,如果超过频率限制,会报错FREQUENCY_LIMITED,请降低频率请求。


path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
商家批次单号 out_batch_no string[5, 32] body商户系统内部的商家批次单号,在商户系统内部唯一。需要电子回单的批次单号
示例值:plfk2020042013

请求示例


{
  "out_batch_no": "plfk2020042013"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
商家批次单号 out_batch_no string[5,32] 商户系统内部的商家批次单号,在商户系统内部唯一。需要电子回单的批次单号
示例值:plfk2020042013
电子回单申请单号 signature_no string[3,45] 电子回单申请单号,申请单据的唯一标识
示例值:1050000010509999485212020110200058820001
电子回单状态 signature_status string[1,10] 枚举值:
ACCEPTED:已受理,电子签章已受理成功
FINISHED:已完成。电子签章已处理完成
示例值:ACCEPTED
电子回单文件的hash方法 hash_type string[1,20] 电子回单文件的hash方法,回单状态为:FINISHED时返回。
示例值:SHA256
电子回单文件的hash值 hash_value string[3,1000] 电子回单文件的hash值,用于下载之后验证文件的完整、正确性,回单状态为:FINISHED时返回。
示例值:DE731F35146A0BEFADE5DB9D1E468D96C01CA8898119C674FEE9F11F4DBE5529
电子回单文件的下载地址 download_url string[10,3000] 电子回单文件的下载地址,回单状态为:FINISHED时返回。URL有效时长为10分钟,10分钟后需要重新去获取下载地址(但不需要走受理)
示例值:https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx
创建时间 create_time string[1, 32] 电子签章单创建时间,遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒
示例值:2020-05-20T13:29:35.120+08:00
更新时间 update_time string[1, 32] 电子签章单最近一次状态变更的时间,遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss.sss表示时分秒毫秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35.120+08:00表示北京时间2015年05月20日13点29分35秒
示例值:2020-05-21T13:29:35.120+08:00

返回示例


{
  "out_batch_no": "plfk2020042013",
  "signature_no": "1050000010509999485212020110200058820001",
  "signature_status": "ACCEPTED",
  "hash_type": "SHA256",
  "hash_value": "DE731F35146A0BEFADE5DB9D1E468D96C01CA8898119C674FEE9F11F4DBE5529",
  "download_url": "https://api.mch.weixin.qq.com/v3/billdownload/file?token=xxx",
  "create_time": "2020-05-20T13:29:35.120+08:00",
  "update_time": "2020-05-21T13:29:35.120+08:00"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 重试
403 NO_AUTH 商户信息不合法 登录商户平台核对,传入正确信息
400 INVALID_REQUEST 参数错误或者不符合业务规则 传入正确参数
PARAM_ERROR 参数错误 登录商户平台核对,输入正确参数
RESOURCE_ALREADY_EXISTS 该批次回单已申请 该商家的电子回单已受理
429 FREQUENCY_LIMITED 频率超限 请降低频率重试


技术咨询

文档反馈