二级商户号

sub_mchid

string[1, 32]

否

Query 若商户是直连商户：

• 无需填写该字段。

若商户是服务商/机构：

• 不填则默认返回服务商/机构下所有账单数据；

• 如需下载某个二级商户下的账单数据，则该字段必填

示例值：19000000001

账单日期

bill_date

string[10, 10]

是

Query 格式yyyy-MM-DD
分账对账单接口只支持下载90天以内的账单。
示例值：2020-01-01

下载地址

download_url

string[1, 2048]

是

供下一步请求账单文件的下载地址，该地址30s内有效
示例值：https://api.mch.weixin.qq.com/v3/bill/downloadurl?token=xxx

Refund apply time

退款申请时间

指该笔交易发起退款时间，格式为YYYY-MM-DD HH:MM:SS，如2015-01-01 10:00:00
示例值：2015-01-01 10:00:00

Refund success time

退款成功时间

指该笔交易退款成功时间，格式为YYYY-MM-DD HH:MM:SS，如2015-01-01 10:00:00
示例值：2015-01-01 10:00:00

Wechat refund number(refund_id)

微信退款单号

微信支付为该笔退款分配的退款单号
示例值：5050000008201712143733500002

Vendor refund number(out_refund_no)

商户退款单号

商户发起退款时填入的商户退款单号
示例值：ST175HQWa0

Wechat order number(transaction_id)

微信订单号

微信支付为该笔退款对应的订单分配的订单号
示例值：4200000008201712143733500001

Vendor order number(out_transaction_id)

商户订单号

商户传入的该笔订单（或该笔退款对应的订单）的商户订单号，对应下单接口里的out_trade_no字段
示例值：test1

Refund amount(refund_fee)

退款单金额

标价币种对应的退款金额
示例值：0.00

Currency type

标价币种

商品标价货币类型，符合ISO 4217标准的三位字母代码，如CNY
示例值：CNY

Coupon refund amount

代金券或立减优惠金额

该笔订单中使用的微信支付代金券金额（包括充值券和免充值券），单位元，保留到小数点后2位
示例值：0.00

Payer's refund amount

用户支付退款金额

用户支付币种对应的退款总金额
示例值：0.00

Payer's refund currency type

用户支付退款币种

用户支付货币类型，符合ISO 4217标准的三位字母代码，如CNY
示例值：CNY

Rate

手续费费率

该笔交易计费所使用的费率，百分数
示例值：0.50%

Refund source

退款出资来源

指一笔分账退款单的退款资金来源，枚举值如下：
1、可垫付退款额度 FUNDS_REFUNDABLE_BALANCE
2、订单未分可退余额 ORDER_REFUNDABLE_BALANCE
示例值：ORDER_REFUNDABLE_BALANCE

Refund source type

退款出资来源组合

指一笔分账退款单的退款资金来源类型，有两种类型：
1）可能是单一来源，比如：一笔100元的退款单，全部使用"订单未分可退余额"完成退款，则展示“SINGLE_SOURCE”；
2）可能是组合来源，比如：一笔100元的退款单，30元从“订单未分可退余额”中出资，70元从“可垫付退款额度”中出资，则展示“PACKAGE”。当通过组合“PACKAGE”的方式执行退款，则需关注同一笔退款当在账单中将呈现多条记录。
枚举值：
1、PACKAGE
2、SINGLE_SOURCE
示例值：PACKAGE

Refund source amount

退款出资额（RMB）

指一笔分账退款单，每项指定的“退款出资来源”实际出资用于退款的金额。
示例值：0.00

Refund source fee in RMB

退款出资额手续费（RMB）

指一笔分账退款单，每部分退款出资额，包含的手续费金额
示例值：-0.02

Refund settlement currency type

退款结算币种

商户发起退款时的货币类型，符合ISO 4217标准的三位字母代码，如CNY
示例值：CNY

Refund exchange rate

退款汇率

退款汇率，外币兑换RMB的比例乘以10的8次方即为此值，例如美元兑换人民币的比例为6.5，则rate=650000000
示例值：650000000
注意：退款汇率值，取退款成功时点的市场汇率，汇率价格由相关合作银行提供。

Refund source settlement amount

退款出资额结算金额

指一笔分账退款单，每部分退款出资额，对应的结算外币金额，特别说明：
1、退款出资源来自“可垫付退款额度（FUNDS_REFUNDABLE_BALANCE ） ”，属于使用待出境结算资金扎差退款，需计算外币结算金额 。
2、退款出资源来自“订单未分可退余额（ORDER_REFUNDABLE_BALANCE）”，属于未出境部分的资金，不会影响结算资金，该值为空。
示例值：0.00

Refund source fee in settlement currency type

退款出资额手续费（结算货币）

指一笔分账退款单，每部分退款出资额，对应的结算外币结算手续费。
1、退款出资源来自“可垫付退款额度（FUNDS_REFUNDABLE_BALANCE ） ”，需计算外币手续费。
2、退款出资源来自“订单未分可退余额（ORDER_REFUNDABLE_BALANCE）”，该值为空。
示例值：-0.00

400

NO_STATEMENT_EXIST

请求的账单文件不存在

请检查当前商户号是否在指定日期有处理成功的分账指令单

400

STATEMENT_CREATING

账单生成中

请先检查当前商户号在指定日期内是否有处理成功的分账指令单，若有，则在T+1日上午10点后再重新下载

403

NO_AUTH

商户父子关系不存在，请使用正确的二级商户号发起请求

请检查二级商户号(sub_mchid)是否填写正确

403

NO_AUTH

商户未签约境外分账产品能力

请参考产品流程和接入准备，确认商户具有分账权限后再发起请求

403

NO_AUTH

商户已开通分账产品能力，等待生效中(一般为第二天才生效)

开通分账产品能力当天不能发起分账，请等待第二天后发起请求