视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

交易賬單文件格式說明

更新時間:2023.09.26

# 寫在前面

本文將介紹交易賬單文件的格式,閱讀本文前可先瀏覽:

# 數(shù)據(jù)組成說明

微信支付的交易賬單的出賬周期是“每日”,日切時間是每日的00:00:00。

交易賬單的數(shù)據(jù)包括支付訂單和退訂單款兩類,不同單據(jù)的數(shù)據(jù)時間是不一樣的:

數(shù)據(jù)類型 數(shù)據(jù)時間 備注
支付 支付成功時間 即下單成功但用戶未支付的訂單不會出賬
退款 商戶退款受理成功時間 出賬后退款狀態(tài)不會更新,原因見關(guān)鍵概念>賬單的數(shù)據(jù)快照。如果需要獲取最新退款狀態(tài),請使用查詢單筆退款A(yù)PI查詢。

支付和退款數(shù)據(jù)是相互獨立的,即,當(dāng)天若對同一筆訂單,先支付成功再退款,在交易賬單中會分別出現(xiàn)“支付”和“退款”兩條數(shù)據(jù)。

基于上面兩種單據(jù)數(shù)據(jù)的組合,微信支付提供了3份不同類型的賬單文件:

  • ALL,包含了數(shù)據(jù)時間在當(dāng)日的所有支付訂單和退款訂單,與商戶平臺內(nèi)交易賬單下載的“所有交易賬單(不含可用余額退款)”相對應(yīng)。
  • SUCCESS,僅包含數(shù)據(jù)時間在當(dāng)日的支付訂單,與商戶平臺內(nèi)交易賬單下載的“支付賬單”相對應(yīng)。
  • REFUND,僅包含數(shù)據(jù)時間在當(dāng)日的退款單,與商戶平臺內(nèi)交易賬單下載的“退款賬單(不含可用余額退款)”相對應(yīng)。

# 文件格式說明

每一份賬單文件在結(jié)構(gòu)上都包含以下四個部分:

  • 明細(xì)數(shù)據(jù)表頭
  • 明細(xì)數(shù)據(jù)
  • 匯總數(shù)據(jù)表頭
  • 匯總數(shù)據(jù)

其中,文件內(nèi)每個字段都使用英文逗號“,” 間隔。明細(xì)數(shù)據(jù)匯總數(shù)據(jù)每個字段前會增加1個字符(用于避免獲取的內(nèi)容被excel展示為科學(xué)計數(shù)法的格式、丟失數(shù)據(jù)細(xì)節(jié))。

具體格式可參考以下文件樣例:

注意

以上樣例為文件展示示例,實際API下載的是數(shù)據(jù)流。

下面針對每一種類型的賬單文件,說明具體字段含義:

# ALL類型賬單

明細(xì)數(shù)據(jù):

字段名 描述 示例值
交易時間 指該筆交易的支付成功時間或商戶退款受理成功時間(注:不是退款成功時間),格式為yyyy-MM-dd HH:MM:SS 2015-01-01 10:00:00
公眾賬號ID 發(fā)起該筆交易時使用的AppID,AppID是由微信給公眾號或App等分配的唯一標(biāo)識 wxab8acb865bb11234
商戶號 發(fā)起該筆交易下單的微信支付商戶號,8~10位數(shù)字 1234567890
特約商戶號 如果是普通受理模式下的交易,展示特約商戶的商戶號,8~10位數(shù)字
如果是普通直連模式交易,則展示成數(shù)字0
1234567890
設(shè)備號 對應(yīng)在下單時傳入的device_info字段,沒填寫則留空 casher001
微信訂單號 微信支付為該筆訂單(或該筆退款對應(yīng)的訂單)分配的訂單號 4200000008201712143733500001
商戶訂單號 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商戶訂單號,對應(yīng)下單接口里的out_trade_no字段 outtradeno001
用戶標(biāo)識 微信為支付用戶在公眾賬號ID(AppID)下分配的唯一標(biāo)識(OpenID) testxt08c-XB5-QD208X1Aid0Cbs
交易類型 該筆訂單(或該筆退款單對應(yīng)的訂單)的類型,使用英文縮寫展示,包括但不限于(后續(xù)可能新增):
MICROPAY:付款碼支付
JSAPI:JSAPI支付、小程序支付
NATIVE:NATIVE支付
APP:App支付
FACE:刷臉支付
NATIVE
交易狀態(tài) 標(biāo)識該筆明細(xì)數(shù)據(jù)的類型:
SUCCESS:支付成功,說明該行數(shù)據(jù)為一筆支付成功的訂單
REFUND:轉(zhuǎn)入退款,說明該行數(shù)據(jù)為一筆發(fā)起退款成功的退款單
REVOKED:已撤銷,說明該行數(shù)據(jù)為一筆在用戶支付成功后發(fā)起撤銷的退款單
SUCCESS
付款銀行 用戶支付時使用的付款方式,包括但不限于(后續(xù)可能新增):
XXX_CREDIT:用戶使用了XXX銀行的一張信用卡付款
XXX_DEBIT:用戶使用了XXX銀行的一張儲蓄卡付款
OTHERS:用戶使用了零錢/零錢通等其他付款方式
CMB_CREDIT
貨幣種類 貨幣類型,符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼 CNY
應(yīng)結(jié)訂單金額 該筆訂單參與計費(fèi)的應(yīng)結(jié)算金額(=訂單金額-用戶使用的免充值券金額),如果該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點后2位 8.88
代金券金額 該筆訂單中使用的微信支付代金券金額(包括充值券和免充值券),如果未使用代金券、或該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點后2位 0.88
微信退款單號 微信支付為該筆退款分配的退款單號,如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS)則展示0 50401010122021000000038202001
商戶退款單號 商戶發(fā)起退款時填入的商戶退款單號,如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS)則展示0 refundno001
退款金額 該筆退款單參與計費(fèi)的應(yīng)結(jié)算金額(申請退款金額-免充值券退款金額),如果該行數(shù)據(jù)為訂單則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點后2位 6.66
充值券退款金額 退款金額中包含的充值券退款金額,如果該行數(shù)據(jù)為訂單或沒有充值券退款則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點后2位 0.66
退款類型 ORIGINAL:原路退款
BALANCE:轉(zhuǎn)退到用戶的微信支付零錢
PLATFORM-ORIGINAL:平臺退款,原路退款
PLATFORM-BALANCE:平臺退款,轉(zhuǎn)退到用戶的微信支付零錢
如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS)則留空
ORIGINAL
退款狀態(tài) 生成賬單文件時該筆退款的狀態(tài)、出賬后不會更新,如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS),則留空
SUCCESS:退款成功
PROCESSING:退款處理中
FAIL:退款失敗
CHANGE:退款異常
SUCCESS
商品名稱 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商品名稱,對應(yīng)下單接口里的body字段 零食
商戶數(shù)據(jù)包 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商戶數(shù)據(jù)包,對應(yīng)下單接口里的attach字段,不傳時留空 交易收款
手續(xù)費(fèi) 該筆訂單/退款對應(yīng)的手續(xù)費(fèi)金額,訂單對應(yīng)正數(shù)、退款對應(yīng)負(fù)數(shù),單位元,保留小數(shù)點后2位 0.01
費(fèi)率 該筆交易計費(fèi)所使用的費(fèi)率,百分?jǐn)?shù) 0.60%
訂單金額 該筆訂單的金額,包括用戶支付金額、充值券金額、免充值券金額,如果該行數(shù)據(jù)為退款或撤銷則填0.00,單位元,保留到小數(shù)點后2位 9.76
申請退款金額 商戶發(fā)起退款的金額,包括退給用戶的金額、充值券退款金額、免充值券退款金額,如果該行數(shù)據(jù)訂單則填0.00,單位元,保留到小數(shù)點后2位 6.66
費(fèi)率備注 對計費(fèi)費(fèi)率的補(bǔ)充說明,如入駐結(jié)算規(guī)則ID、優(yōu)惠費(fèi)率活動ID等,可為空 726

匯總數(shù)據(jù):

字段名 描述 示例值
總交易單數(shù) 該份賬單內(nèi)明細(xì)數(shù)據(jù)的筆數(shù) 200
應(yīng)結(jié)訂單總金額 賬單內(nèi)所有應(yīng)結(jié)訂單金額字段之和,保留小數(shù)點后2位 888.00
退款總金額 賬單內(nèi)所有退款金額字段之和,保留小數(shù)點后2位 666.00
充值券退款總金額 賬單內(nèi)所有充值券退款金額字段之和,保留小數(shù)點后2位 6.60
手續(xù)費(fèi)總金額 賬單內(nèi)所有交易手續(xù)費(fèi)字段之和,保留小數(shù)點后2位 10.00
訂單總金額 賬單內(nèi)所有交易訂單金額字段之和,保留小數(shù)點后2位 976.00
申請退款總金額 賬單內(nèi)所有申請退款金額字段之和,保留小數(shù)點后2位 666.00

# SUCCESS類型賬單

明細(xì)數(shù)據(jù):

字段名 描述 示例值
交易時間 指該筆交易的支付成功時間,格式為yyyy-MM-dd HH:MM:SS 2015-01-01 10:00:00
公眾賬號ID 發(fā)起該筆交易時使用的AppID,AppID是由微信給公眾號或App等分配的唯一標(biāo)識 wxab8acb865bb11234
商戶號 發(fā)起該筆交易下單的微信支付商戶號,8~10位數(shù)字 1234567890
特約商戶號 如果是普通受理模式下的交易,展示特約商戶的商戶號,8~10位數(shù)字
如果是普通直連模式交易,則展示成數(shù)字0
1234567890
設(shè)備號 對應(yīng)在下單時傳入的device_info字段,沒填寫則留空 casher001
微信訂單號 微信支付為該筆訂單(或該筆退款對應(yīng)的訂單)分配的訂單號 4200000008201712143733500001
商戶訂單號 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商戶訂單號,對應(yīng)下單接口里的out_trade_no字段 outtradeno001
用戶標(biāo)識 微信為支付用戶在公眾賬號ID(AppID)下分配的唯一標(biāo)識(OpenID) testxt08c-XB5-QD208X1Aid0Cbs
交易類型 該筆訂單(或該筆退款單對應(yīng)的訂單)的類型,使用英文縮寫展示,包括但不限于(后續(xù)可能新增):
MICROPAY:付款碼支付
JSAPI:JSAPI支付、小程序支付
NATIVE:NATIVE支付
APP:App支付
FACE:刷臉支付
NATIVE
交易狀態(tài) 標(biāo)識該筆明細(xì)數(shù)據(jù)的類型:
SUCCESS:支付成功,說明該行數(shù)據(jù)為一筆支付成功的訂單
REFUND:轉(zhuǎn)入退款,說明該行數(shù)據(jù)為一筆發(fā)起退款成功的退款單
REVOKED:已撤銷,說明該行數(shù)據(jù)為一筆在用戶支付成功后發(fā)起撤銷的退款單
SUCCESS
付款銀行 用戶支付時使用的付款方式,包括但不限于(后續(xù)可能新增):
XXX_CREDIT:用戶使用了XXX銀行的一張信用卡付款
XXX_DEBIT:用戶使用了XXX銀行的一張儲蓄卡付款
OTHERS:用戶使用了零錢/零錢通等其他付款方式
CMB_CREDIT
貨幣種類 貨幣類型,符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼 CNY
應(yīng)結(jié)訂單金額 該筆訂單參與計費(fèi)的應(yīng)結(jié)算金額(=訂單金額-用戶使用的免充值券金額),如果該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點后2位 8.88
代金券金額 該筆訂單中使用的微信支付代金券金額(包括充值券和免充值券),如果未使用代金券、或該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點后2位 0.88
商品名稱 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商品名稱,對應(yīng)下單接口里的body字段 零食
商戶數(shù)據(jù)包 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商戶數(shù)據(jù)包,對應(yīng)下單接口里的attach字段,不傳時留空 交易收款
手續(xù)費(fèi) 該筆訂單/退款對應(yīng)的手續(xù)費(fèi)金額,訂單對應(yīng)正數(shù)、退款對應(yīng)負(fù)數(shù),單位元,保留小數(shù)點后2位 0.01
費(fèi)率 該筆交易計費(fèi)所使用的費(fèi)率,百分?jǐn)?shù) 0.60%
訂單金額 該筆訂單的金額,包括用戶支付金額、充值券金額、免充值券金額,如果該行數(shù)據(jù)為退款或撤銷則填0.00,單位元,保留到小數(shù)點后2位 9.76
費(fèi)率備注 對計費(fèi)費(fèi)率的補(bǔ)充說明,如入駐結(jié)算規(guī)則ID、優(yōu)惠費(fèi)率活動ID等,可為空 726

匯總數(shù)據(jù):

字段名 描述 示例值
總交易單數(shù) 該份賬單內(nèi)明細(xì)數(shù)據(jù)的筆數(shù) 200
應(yīng)結(jié)訂單總金額 賬單內(nèi)所有應(yīng)結(jié)訂單金額字段之和,保留小數(shù)點后2位 888.00
手續(xù)費(fèi)總金額 賬單內(nèi)所有交易手續(xù)費(fèi)字段之和,保留小數(shù)點后2位 10.00
訂單總金額 賬單內(nèi)所有交易訂單金額字段之和,保留小數(shù)點后2位 976.00

# REFUND類型賬單

明細(xì)數(shù)據(jù):

字段名 描述 示例值
交易時間 指商戶退款受理成功時間(注:不是退款成功時間),格式為yyyy-MM-dd HH:MM:SS 2015-01-01 10:00:00
公眾賬號ID 發(fā)起該筆交易時使用的AppID,AppID是由微信給公眾號或App等分配的唯一標(biāo)識 wxab8acb865bb11234
商戶號 發(fā)起該筆交易下單的微信支付商戶號,8~10位數(shù)字 1234567890
特約商戶號 如果是普通受理模式下的交易,展示特約商戶的商戶號,8~10位數(shù)字
如果是普通直連模式交易,則展示成數(shù)字0
1234567890
設(shè)備號 對應(yīng)在下單時傳入的device_info字段,沒填寫則留空 casher001
微信訂單號 微信支付為該筆訂單(或該筆退款對應(yīng)的訂單)分配的訂單號 4200000008201712143733500001
商戶訂單號 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商戶訂單號,對應(yīng)下單接口里的out_trade_no字段 outtradeno001
用戶標(biāo)識 微信為支付用戶在公眾賬號ID(AppID)下分配的唯一標(biāo)識(OpenID) testxt08c-XB5-QD208X1Aid0Cbs
交易類型 該筆訂單(或該筆退款單對應(yīng)的訂單)的類型,使用英文縮寫展示,包括但不限于(后續(xù)可能新增):
MICROPAY:付款碼支付
JSAPI:JSAPI支付、小程序支付
NATIVE:NATIVE支付
APP:App支付
FACE:刷臉支付
NATIVE
交易狀態(tài) 標(biāo)識該筆明細(xì)數(shù)據(jù)的類型:
SUCCESS:支付成功,說明該行數(shù)據(jù)為一筆支付成功的訂單
REFUND:轉(zhuǎn)入退款,說明該行數(shù)據(jù)為一筆發(fā)起退款成功的退款單
REVOKED:已撤銷,說明該行數(shù)據(jù)為一筆在用戶支付成功后發(fā)起撤銷的退款單
SUCCESS
付款銀行 用戶支付時使用的付款方式,包括但不限于(后續(xù)可能新增):
XXX_CREDIT:用戶使用了XXX銀行的一張信用卡付款
XXX_DEBIT:用戶使用了XXX銀行的一張儲蓄卡付款
OTHERS:用戶使用了零錢/零錢通等其他付款方式
CMB_CREDIT
貨幣種類 貨幣類型,符合ISO 4217標(biāo)準(zhǔn)的三位字母代碼 CNY
應(yīng)結(jié)訂單金額 該筆訂單參與計費(fèi)的應(yīng)結(jié)算金額(=訂單金額-用戶使用的免充值券金額),如果該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點后2位 8.88
代金券金額 該筆訂單中使用的微信支付代金券金額(包括充值券和免充值券),如果未使用代金券、或該行數(shù)據(jù)為退款或撤銷則展示0.00,單位元,保留到小數(shù)點后2位 0.88
退款申請時間 指商戶發(fā)起退款申請時間,格式為yyyy-MM-dd HH:MM:SS 2015-01-01 10:00:00
退款成功時間 指退款成功時間,格式為yyyy-MM-dd HH:MM:SS 2015-01-01 10:00:00
微信退款單號 微信支付為該筆退款分配的退款單號,如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS)則展示0 50401010122021000000038202001
商戶退款單號 商戶發(fā)起退款時填入的商戶退款單號,如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS)則展示0 refundno001
退款金額 該筆退款單參與計費(fèi)的應(yīng)結(jié)算金額(申請退款金額-免充值券退款金額),如果該行數(shù)據(jù)為訂單則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點后2位 6.66
充值券退款金額 退款金額中包含的充值券退款金額,如果該行數(shù)據(jù)為訂單或沒有充值券退款則展示為0.00,非負(fù)數(shù)、單位元,保留到小數(shù)點后2位 0.66
退款類型 ORIGINAL:原路退款
BALANCE:轉(zhuǎn)退到用戶的微信支付零錢
PLATFORM-ORIGINAL:平臺退款,原路退款
PLATFORM-BALANCE:平臺退款,轉(zhuǎn)退到用戶的微信支付零錢
如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS)則留空
ORIGINAL
退款狀態(tài) 生成賬單文件時該筆退款的狀態(tài)、出賬后不會更新,如果該行數(shù)據(jù)為訂單(交易狀態(tài)SUCCESS),則留空
SUCCESS:退款成功
PROCESSING:退款處理中
FAIL:退款失敗
CHANGE:退款異常
SUCCESS
商品名稱 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商品名稱,對應(yīng)下單接口里的body字段 零食
商戶數(shù)據(jù)包 商戶傳入的該筆訂單(或該筆退款對應(yīng)的訂單)的商戶數(shù)據(jù)包,對應(yīng)下單接口里的attach字段,不傳時留空 交易收款
手續(xù)費(fèi) 該筆訂單/退款對應(yīng)的手續(xù)費(fèi)金額,訂單對應(yīng)正數(shù)、退款對應(yīng)負(fù)數(shù),單位元,保留小數(shù)點后2位 0.01
費(fèi)率 該筆交易計費(fèi)所使用的費(fèi)率,百分?jǐn)?shù) 0.60%
訂單金額 該筆訂單的金額,包括用戶支付金額、充值券金額、免充值券金額,如果該行數(shù)據(jù)為退款或撤銷則填0.00,單位元,保留到小數(shù)點后2位 9.76
申請退款金額 商戶發(fā)起退款的金額,包括退給用戶的金額、充值券退款金額、免充值券退款金額,如果該行數(shù)據(jù)訂單則填0.00,單位元,保留到小數(shù)點后2位 6.66
費(fèi)率備注 對計費(fèi)費(fèi)率的補(bǔ)充說明,如入駐結(jié)算規(guī)則ID、優(yōu)惠費(fèi)率活動ID等,可為空 726

匯總數(shù)據(jù):

字段名 描述 示例值
總交易單數(shù) 該份賬單內(nèi)明細(xì)數(shù)據(jù)的筆數(shù) 200
應(yīng)結(jié)訂單總金額 賬單內(nèi)所有應(yīng)結(jié)訂單金額字段之和,保留小數(shù)點后2位 888.00
退款總金額 賬單內(nèi)所有退款金額字段之和,保留小數(shù)點后2位 666.00
充值券退款總金額 賬單內(nèi)所有充值券退款金額字段之和,保留小數(shù)點后2位 6.60
手續(xù)費(fèi)總金額 賬單內(nèi)所有交易手續(xù)費(fèi)字段之和,保留小數(shù)點后2位 10.00
訂單總金額 賬單內(nèi)所有交易訂單金額字段之和,保留小數(shù)點后2位 976.00
申請退款總金額 賬單內(nèi)所有申請退款金額字段之和,保留小數(shù)點后2位 666.00

# 特殊字符轉(zhuǎn)義

針對明細(xì)數(shù)據(jù)中的商品名稱商戶數(shù)據(jù)包設(shè)備號這三個商戶自定義字段,賬單在處理過程中對其進(jìn)行了特殊字符的轉(zhuǎn)義,具體規(guī)則包括:

原始特殊字符
Unicode

含義
訂單轉(zhuǎn)義
Unicode

含義
退款單轉(zhuǎn)義
Unicode

含義
\u005c \ \u005c\u005c \\ \u005c\u005c \\
\u0027 ' \u005c\u0027 \' \u0027 '
\u0022 " \u005c\u0022 \" \u005c\u0022 \"
\u0060 ` \u005c\u0060 \` \u005c\u0031\u0034\u0030 \140
\u002c , \u005c\u0020 \空格 \u005c\u0020 \空格
\u000a 換行符(LF) \u005c\u006e \n \u005c\u006e \n
\u000d 回車符(CR) \u005c\u0072 \r \u005c\u0072 \r
\u0009 制表符(HT) \u005c\u0074 \t \u005c\u0074 \t
\ue000 不可見字符(\xee\x80\x80) \u005c\u0020 \空格 \u005c\u0020 \空格
\u001a 控制字符SUB(\032) \u005c\u001a \控制字符SUB \u005c\u001a \控制字符SUB

# 其他說明

少部分商戶目前的賬單格式停留在歷史早期版本,具體表現(xiàn)為:沒有應(yīng)結(jié)算訂單金額字段、對應(yīng)的是總金額字段,沒有代金券金額字段、對應(yīng)的是企業(yè)紅包金額字段。如需調(diào)整為最新格式的賬單,可以通過在產(chǎn)品中心中開通免充值優(yōu)惠券功能,次日開始的賬單格式即會完成變更。