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

转账明细电子回单受理API

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


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

注意:

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

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

• 仅支持转账已完成的明细单申请电子回单(不满足条件返回:400 PARAM_ERROR);

接口说明

适用对象:直连商户

请求URL:https://api.mch.weixin.qq.com/v3/transfer-detail/electronic-receipts

请求方式:POST

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

前置条件:只支持受理最近30天内的转账明细单


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
受理类型 accept_type string[1,32] body电子回单受理类型:
BATCH_TRANSFER:批量转账明细电子回单
TRANSFER_TO_POCKET:企业付款至零钱电子回单
TRANSFER_TO_BANK:企业付款至银行卡电子回单
示例值:BATCH_TRANSFER
商家转账批次单号 out_batch_no string[5, 32] body需要电子回单的批量转账明细单所在的转账批次单号,该单号为商户申请转账时生成的商户单号。受理类型为BATCH_TRANSFER时该单号必填,否则该单号留空。
示例值:GD2021011610162610BBdkkIwcu3
商家转账明细单号 out_detail_no string[5, 32] body该单号为商户申请转账时生成的商家转账明细单号。
1.受理类型为BATCH_TRANSFER时填写商家批量转账明细单号。
2. 受理类型为TRANSFER_TO_POCKET或TRANSFER_TO_BANK时填写商家转账单号。
示例值:mx0911231610162610v4CNkO4HAf

请求示例


{
  "accept_type": "BATCH_TRANSFER",
  "out_batch_no": "GD2021011610162610BBdkkIwcu3",
  "out_detail_no": "mx0911231610162610v4CNkO4HAf"
}

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
受理类型 accept_type string[1,32] 电子回单受理类型:
BATCH_TRANSFER:批量转账明细电子回单
TRANSFER_TO_POCKET:企业付款至零钱电子回单
TRANSFER_TO_BANK:企业付款至银行卡电子回单
示例值:BATCH_TRANSFER
商家转账批次单号 out_batch_no string[5, 32] 需要电子回单的批量转账明细单所在的转账批次单号,该单号为商户申请转账时生成的商户单号。受理类型为BATCH_TRANSFER时该单号必填,否则该单号留空。
示例值:GD2021011610162610BBdkkIwcu3
商家转账明细单号 out_detail_no string[5, 32] 该单号为商户申请转账时生成的商家转账明细单号。
1.受理类型为BATCH_TRANSFER时填写商家批量转账明细单号。
2. 受理类型为TRANSFER_TO_POCKET或TRANSFER_TO_BANK时填写商家转账单号。
示例值:mx0911231610162610v4CNkO4HAf
电子回单受理单号 signature_no string[3, 256] 电子回单受理单号,受理单据的唯一标识
示例值: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

返回示例


{
  "accept_type": "BATCH_TRANSFER",
  "out_batch_no": "GD2021011610162610BBdkkIwcu3",
  "out_detail_no": "mx0911231610162610v4CNkO4HAf",
  "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"
}
                    

http://2323weixin.qq.com
                    

错误码公共错误码

状态码 错误码 描述 解决方案
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
403 NO_AUTH 商户信息不合法 登录商户平台核对,传入正确信息
400 INVALID_REQUEST 参数错误或者不符合业务规则 传入正确参数
PARAM_ERROR 参数错误 登录商户平台核对,输入正确参数
ALREADY_EXISTS 订单已存在 该商家的电子回单已受理
429 FREQUENCY_LIMITED 频率超限 请降低频率重试


技术咨询

文档反馈