最新更新时间: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
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
下载地址 | 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"
}
• 账单文件包括明细数据和汇总数据两部分,每一部分都包含一行表头和若干行具体数据;
• 明细数据每一行对应一笔分账,同时每一个数据前加入了字符`,以避免数据被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 | 商户已开通分账产品能力,等待生效中(一般为第二天才生效) | 开通分账产品能力当天不能发起分账,请等待第二天后发起请求 |
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证