Login expired. Please log in again.

Feedback

0/300

Feedback

Submitted successfully

ok

Feedback

Network exception, please try again later

ok

获取分账账单文件下载地址API

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


微信支付按天提供分账账单文件,商户可以通过该接口获取账单文件的下载地址。文件内包含分账相关的金额、时间等信息,供商户核对到账等情况。

注意:

• 微信侧未成功的分账单不会出现在对账单中;

• 对账单中涉及金额的字段单位为“元”。

接口说明

适用对象:直连模式 机构模式

请求URL:https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url

请求方式:get


path 指该参数为路径参数

query 指该参数为URL参数

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


请求参数

参数名 变量 类型[长度限制] 必填 描述
二级商户号 sub_mchid string[1, 32] query若商户是直连商户:无需填写该字段。
若商户是服务商/机构:必填,填写需要下载账单的对应二级商户号。
示例值:19000000001
账单日期 bill_date string[10, 10] query格式yyyy-MM-DD
示例值:2020-01-01

请求示例


https://api.mch.weixin.qq.com/v3/global/profit-sharing/bill-download-url?sub_mchid=19000000001&bill_date=2020-01-01

{
JAVA示例代码
}

返回参数

参数名 变量 类型[长度限制] 必填 描述
下载地址 download_url string[1, 2048] 供下一步请求账单文件的下载地址,该地址30s内有效
示例值:https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx

返回示例


{
  "download_url": "https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx"
}
                    

http://2323weixin.qq.com
                    

文件格式说明

• 账单文件包括明细数据和汇总数据两部分,每一部分都包含一行表头和若干行具体数据;

• 明细数据每一行对应一笔分账,同时每一个数据前加入了字符`,以避免数据被Excel按科学计数法处理。如需汇总金额等数据,可以批量替换掉该字符。

• 数据头的格式为:create_time,initiator,sponsor,sub_mchid,transaction_id,order_id,out_order_no,detail_id,receiver_account,amount,currency,
settlement_amount,settlement_currency,exchange_rate,business_type,status,description; 对应的含义见下表:


变量 字段名 描述
create_time 分账发起时间 商户请求该笔分账/系统发起逾期解冻的系统受理时间
initiator 分账发起方 若为商户发起,则为发起方商户号; 若为系统发起,则为"system"
sponsor 分账出资方 实际出资的商户号,同结算入账商户
sub_mchid 二级商户号 该笔分账对应交易订单的二级商户号
transaction_id 微信支付订单号 带有分账标记的微信支付订单号
order_id 微信分账单号 请求分账时,微信返回给商户的分账单号
out_order_no 商户分账单号 商户请求分账时,传入的商户分账单号;若为系统发起的逾期解冻指令,则该字段为空
detail_id 微信分账明细单号 该笔分账对应的转账明细单号,对应商户请求分账时的某个接收方收款
receiver_account 分账接收方账户 分出时接收方账户,若为解冻购汇(business_type=TO_SPONSOR)时则为空
amount 分账金额 该笔分账明细子单的实际分账金额
currency 分账币种
settlement_amount 解冻出境金额 只有解冻出境购汇(business_type=TO_SPONSOR)才有
settlement_currency 结算币种 只有解冻出境购汇(business_type=TO_SPONSOR)才有
exchange_rate 汇率 只有解冻出境购汇(business_type=TO_SPONSOR)才有
business_type 业务类型 分出:TO_ACCEPTOR;解冻出境:TO_SPONSOR
status 处理状态 "SUCCESS",目前只有成功的单据才出账单
description 分账描述 商户传入的分账描述内容;若为系统发起逾期解冻,则为"Unfreeze the remaining funds to sponsor"

• 汇总头的格式为:total_count,total_amount_to_sponsor,total_amount_to_acceptor;对应的含义为:账单总条数,当天解冻总金额,当天分出总金额;

• 数据行和汇总头之间有空行。


create_time,initiator,sponsor,sub_mchid,transaction_id,order_id,out_order_no,detail_id,receiver_account,amount,currency,settlement_amount,settlement_currency,exchange_rate,business_type,status,description
`2020-08-01 15:19:53,`1489578022,`1489578022,`1489578025,`4200001201202111086372797299,`7100010010202111091636447398824,`HX3804579307200708608,`7200010010202111091636447398823,`,`80.38,`CNY,`16.40,`AUD,`490176891,`TO_SPONSOR,`SUCCESS,`Unfreeze the remaining funds to sponsor

total_count,total_amount_to_sponsor,total_amount_to_acceptor
`1,`80.38,`0

错误码

状态码 错误码 描述 解决方案
400 NO_STATEMENT_EXIST 请求的账单文件不存在 请检查当前商户号是否在指定日期有处理成功的分账指令单
400 STATEMENT_CREATING 账单生成中 请先检查当前商户号在指定日期内是否有处理成功的分账指令单,若有,则在T+1日上午10点后再重新下载
403 NO_AUTH 商户父子关系不存在,请使用正确的二级商户号发起请求 请检查二级商户号(sub_mchid)是否填写正确
403 NO_AUTH 商户未签约境外分账产品能力 请参考产品流程和接入准备,确认商户具有分账权限后再发起请求
403 NO_AUTH 商户已开通分账产品能力,等待生效中(一般为第二天才生效) 开通分账产品能力当天不能发起分账,请等待第二天后发起请求




版本说明

关闭
V1.0
2022年04月11日
获取分账账单文件下载地址API接口上线

About  WeChat  Pay

Powered By Tencent & Tenpay Copyright©

2005-2024 Tenpay All Rights Reserved.

Contact Us
Wechat Pay Global

WeChat Pay Global