交易账单的文件格式
账单文件包括明细数据和汇总数据两部分,每一部分都包含一行表头和若干行具体数据。 明细数据每一行对应一笔订单或一笔退款,同时每一个数据前加入了字符`,以避免数据被Excel按科学计数法处理。如需汇总金额等数据,可以批量替换掉该字符。
此外,微信支付提供了3份不同类型的账单文件,详细可以参考下方的字段说明。
字段名描述示例值交易时间指该笔交易的支付成功时间或发起退款成功时间(注:不是退款成功时间),格式为yyyy-MM-dd HH:MM:SS2015-01-01 10:00:00公众账号ID发起该笔交易时使用的AppID,AppID是由微信给公众号或App等分配的唯一标识wxab8acb865bb11234商户号发起该笔交易下单的微信支付商户号,8~10位数字1234567890设备号对应在下单时传入的device_info字段,没填写则留空 casher001微信订单号微信支付为该笔订单(或该笔退款对应的订单)分配的订单号
4200000008201712143733500001商户订单号商户传入的该笔订单(或该笔退款对应的订单)的商户订单号,对应下单接口里的out_trade_no字段outtradeno001用户标识微信为支付用户在公众账号ID(AppID)下分配的唯一标识(OpenID)
testxt08c-XB5-QD208X1Aid0Cbs交易类型该笔订单(或该笔退款单对应的订单)的类型,使用英文缩写展示,包括但不限于(后续可能新增):
MICROPAY,付款码支付
JSAPI,JSAPI支付、小程序支付
NATIVE,Native支付
App,App支付
FACE,刷脸支付NATIVE交易状态标识该笔明细数据的类型:
SUCCESS,支付成功,说明该行数据为一笔支付成功的订单
REFUND,转入退款,说明该行数据为一笔发起退款成功的退款单
REVOKED,已撤销,说明该行数据为一笔在用户支付成功后发起撤销的退款单SUCCESS付款银行用户支付时使用的付款方式,包括但不限于(后续可能新增):
XXX_CREDIT,用户使用了XXX银行的一张信用卡付款
XXX_DEBIT,用户使用了XXX银行的一张储蓄卡付款
OTHERS,用户使用了零钱/零钱通等其他付款方式CMB_CREDIT货币种类货币类型,符合ISO 4217标准的三位字母代码CNY应结订单金额该笔订单参与计费的应结算金额(=订单金额-用户使用的免充值券金额),如果该行数据为退款或撤销则展示0.00,单位元,保留到小数点后2位8.88代金券金额该笔订单中使用的微信支付代金券金额(包括充值券和免充值券),如果未使用代金券、或该行数据为退款或撤销则展示0.00,单位元,保留到小数点后2位0.88微信退款单号微信支付为该笔退款分配的退款单号,如果该行数据为订单(交易状态SUCCESS)则展示
050401010122021000000038202001商户退款单号商户发起退款时填入的商户退款单号,如果该行数据为订单(交易状态SUCCESS)则展示0refundno001退款金额该笔退款单参与计费的应结算金额(申请退款金额-免充值券退款金额),如果该行数据为订单则展示为0.00,非负数、单位元,保留到小数点后2位6.66充值券退款金额退款金额中包含的充值券退款金额,如果该行数据为订单或没有充值券退款则展示为0.00,非负数、单位元,保留到小数点后2位0.66退款类型ORIGINAL—原路退款
BALANCE—转退到用户的微信支付零钱
如果该行数据为订单(交易状态SUCCESS)则留空ORIGINAL退款状态生成账单文件时该笔退款的状态、出账后不会更新,如果该行数据为订单(交易状态SUCCESS),则留空
SUCCESS,退款成功
PROCESSING,退款处理中
FAIL,退款失败
CHANGE,退款异常SUCCESS商品名称商户传入的该笔订单(或该笔退款对应的订单)的商品名称,对应下单接口里的body字段零食商户数据包商户传入的该笔订单(或该笔退款对应的订单)的商户数据包,对应下单接口里的attach字段,不传时留空交易收款手续费该笔订单/退款对应的手续费金额,订单对应正数、退款对应负数,单位元,保留小数点后2位0.01费率该笔交易计费所使用的费率,百分数0.60%订单金额该笔订单的金额,包括用户支付金额、充值券金额、免充值券金额,如果该行数据为退款或撤销则填0.00,单位元,保留到小数点后2位9.76申请退款金额商户发起退款的金额,包括退给用户的金额、充值券退款金额、免充值券退款金额,如果该行数据为非退款订单则填0.00,单位元,保留到小数点后2位6.66费率备注对计费费率的补充说明,如入驻结算规则ID、优惠费率活动ID等,可为空726
字段名描述示例值总交易单数该份账单内明细数据的笔数200应结订单总金额账单内所有应结订单金额字段之和,保留小数点后2位888.00退款总金额账单内所有退款金额字段之和,保留小数点后2位666.00充值券退款总金额账单内所有充值券退款金额字段之和,保留小数点后2位6.60手续费总金额账单内所有交易手续费字段之和,保留小数点后2位10.00订单总金额账单内所有交易订单金额字段之和,保留小数点后2位976.00申请退款总金额账单内所有申请退款金额字段之和,保留小数点后2位666.00
交易时间,公众账号ID,商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,商品名称,商户数据包,手续费,费率,订单金额,费率备注
ALL账单数据范围已经包含了SUCCESS账单的部分,详细的字段描述含义,请参考 ALL类型账单文件具体字段 中的内容
交易时间,公众账号ID,商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,退款申请时间,退款成功时间,微信退款单号,商户退款单号,退款金额,充值券退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率,订单金额,申请退款金额,费率备注
ALL账单数据范围已经包含了REFUND账单的部分,详细的字段描述含义,请参考 ALL类型账单文件具体字段 中的内容
账单处理过程会对商品名称、商户数据包、设备号等商户自定义字段进行特殊字符转义,具体规则包括:
'转换成为\\'
"转换成为\\"
\``转换成为\``
,转换成为\\ (\+空格)
\r转换成为\\\r
\t转换成为\\\t
少部分商户目前的账单格式停留在历史早期版本,具体表现为:没有应结算订单金额字段、对应的是总金额字段,没有代金券金额字段、对应的是企业红包金额字段。如需调整为最新格式的账单,可以通过在产品中心中开通免充值优惠券功能,次日开始的账单格式即会完成变更。
功能介绍
微信支付资金账单是一款适用于各类商户的产品,它提供全面、详细的交易流水记录信息,包含该账户资金操作相关的业务单号、收支金额、记账时间等信息。商户可以通过资金账单轻松查询和管理流水记录,供商户进行核对。
交易账单的文件格式
账单文件包括明细数据和汇总数据两部分,每一部分都包含一行表头和若干行具体数据。 明细数据每一行对应一笔订单或一笔退款,同时每一个数据前加入了字符`,以避免数据被Excel按科学计数法处理。如需汇总金额等数据,可以批量替换掉该字符。
此外,微信支付提供了3份不同类型的账单文件,详细可以参考下方的字段说明。
字段名描述示例值交易时间指该笔交易的支付成功时间或发起退款成功时间(注:不是退款成功时间),格式为yyyy-MM-dd HH:MM:SS2015-01-01 10:00:00公众账号ID发起该笔交易时使用的AppID,AppID是由微信给公众号或App等分配的唯一标识wxab8acb865bb11234商户号发起该笔交易下单的微信支付商户号,8~10位数字1234567890设备号对应在下单时传入的device_info字段,没填写则留空 casher001微信订单号微信支付为该笔订单(或该笔退款对应的订单)分配的订单号
4200000008201712143733500001商户订单号商户传入的该笔订单(或该笔退款对应的订单)的商户订单号,对应下单接口里的out_trade_no字段outtradeno001用户标识微信为支付用户在公众账号ID(AppID)下分配的唯一标识(OpenID)
testxt08c-XB5-QD208X1Aid0Cbs交易类型该笔订单(或该笔退款单对应的订单)的类型,使用英文缩写展示,包括但不限于(后续可能新增):
MICROPAY,付款码支付
JSAPI,JSAPI支付、小程序支付
NATIVE,Native支付
App,App支付
FACE,刷脸支付NATIVE交易状态标识该笔明细数据的类型:
SUCCESS,支付成功,说明该行数据为一笔支付成功的订单
REFUND,转入退款,说明该行数据为一笔发起退款成功的退款单
REVOKED,已撤销,说明该行数据为一笔在用户支付成功后发起撤销的退款单SUCCESS付款银行用户支付时使用的付款方式,包括但不限于(后续可能新增):
XXX_CREDIT,用户使用了XXX银行的一张信用卡付款
XXX_DEBIT,用户使用了XXX银行的一张储蓄卡付款
OTHERS,用户使用了零钱/零钱通等其他付款方式CMB_CREDIT货币种类货币类型,符合ISO 4217标准的三位字母代码CNY应结订单金额该笔订单参与计费的应结算金额(=订单金额-用户使用的免充值券金额),如果该行数据为退款或撤销则展示0.00,单位元,保留到小数点后2位8.88代金券金额该笔订单中使用的微信支付代金券金额(包括充值券和免充值券),如果未使用代金券、或该行数据为退款或撤销则展示0.00,单位元,保留到小数点后2位0.88微信退款单号微信支付为该笔退款分配的退款单号,如果该行数据为订单(交易状态SUCCESS)则展示
050401010122021000000038202001商户退款单号商户发起退款时填入的商户退款单号,如果该行数据为订单(交易状态SUCCESS)则展示0refundno001退款金额该笔退款单参与计费的应结算金额(申请退款金额-免充值券退款金额),如果该行数据为订单则展示为0.00,非负数、单位元,保留到小数点后2位6.66充值券退款金额退款金额中包含的充值券退款金额,如果该行数据为订单或没有充值券退款则展示为0.00,非负数、单位元,保留到小数点后2位0.66退款类型ORIGINAL—原路退款
BALANCE—转退到用户的微信支付零钱
如果该行数据为订单(交易状态SUCCESS)则留空ORIGINAL退款状态生成账单文件时该笔退款的状态、出账后不会更新,如果该行数据为订单(交易状态SUCCESS),则留空
SUCCESS,退款成功
PROCESSING,退款处理中
FAIL,退款失败
CHANGE,退款异常SUCCESS商品名称商户传入的该笔订单(或该笔退款对应的订单)的商品名称,对应下单接口里的body字段零食商户数据包商户传入的该笔订单(或该笔退款对应的订单)的商户数据包,对应下单接口里的attach字段,不传时留空交易收款手续费该笔订单/退款对应的手续费金额,订单对应正数、退款对应负数,单位元,保留小数点后2位0.01费率该笔交易计费所使用的费率,百分数0.60%订单金额该笔订单的金额,包括用户支付金额、充值券金额、免充值券金额,如果该行数据为退款或撤销则填0.00,单位元,保留到小数点后2位9.76申请退款金额商户发起退款的金额,包括退给用户的金额、充值券退款金额、免充值券退款金额,如果该行数据为非退款订单则填0.00,单位元,保留到小数点后2位6.66费率备注对计费费率的补充说明,如入驻结算规则ID、优惠费率活动ID等,可为空726
字段名描述示例值总交易单数该份账单内明细数据的笔数200应结订单总金额账单内所有应结订单金额字段之和,保留小数点后2位888.00退款总金额账单内所有退款金额字段之和,保留小数点后2位666.00充值券退款总金额账单内所有充值券退款金额字段之和,保留小数点后2位6.60手续费总金额账单内所有交易手续费字段之和,保留小数点后2位10.00订单总金额账单内所有交易订单金额字段之和,保留小数点后2位976.00申请退款总金额账单内所有申请退款金额字段之和,保留小数点后2位666.00
交易时间,公众账号ID,商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,商品名称,商户数据包,手续费,费率,订单金额,费率备注
ALL账单数据范围已经包含了SUCCESS账单的部分,详细的字段描述含义,请参考 ALL类型账单文件具体字段 中的内容
交易时间,公众账号ID,商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,退款申请时间,退款成功时间,微信退款单号,商户退款单号,退款金额,充值券退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率,订单金额,申请退款金额,费率备注
ALL账单数据范围已经包含了REFUND账单的部分,详细的字段描述含义,请参考 ALL类型账单文件具体字段 中的内容
账单处理过程会对商品名称、商户数据包、设备号等商户自定义字段进行特殊字符转义,具体规则包括:
'转换成为\\'
"转换成为\\"
\``转换成为\``
,转换成为\\ (\+空格)
\r转换成为\\\r
\t转换成为\\\t
少部分商户目前的账单格式停留在历史早期版本,具体表现为:没有应结算订单金额字段、对应的是总金额字段,没有代金券金额字段、对应的是企业红包金额字段。如需调整为最新格式的账单,可以通过在产品中心中开通免充值优惠券功能,次日开始的账单格式即会完成变更。
API列表
功能列表描述申请资金账单商户可以通过该接口获取资金账单文件的下载地址。申请交易账单商户可以通过该接口获取交易账单文件的下载地址。下载交易/资金账单通过申请交易/资金账单获取到download_url在该接口获取到对应的账单。
2025-04-01 10:19:24
2025-04-01 09:46:09
2025-04-01 06:38:28
2025-04-01 04:19:18