微信支付-融合錢包開發(fā)者文檔

返回上一層融合錢包 / 公眾號支付 / 查詢結算資金明細API

查詢結算資金明細API

最新更新時間：2022.03.02 版本說明

商戶在交易完結之后，可按結算日期查詢已結算資金明細（sette_state為SETTLED），也可以查詢未結算資金明細（sette_state為UNSETTLE）。

注意：

該接口供跨境收單機構/直連商戶使用，特別是，日本/澳門機構商戶若開通香港錢包業(yè)務，需要對接該接口。

接口說明

適用對象：直連模式機構模式

接口URL：https://api.mch.weixin.qq.com/hk/v3/settle/settlements

請求方式：GET

接口規(guī)則：https://wechatpay-api.gitbook.io/wechatpay-api-v3/

path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)為URL參數(shù)

body 指該參數(shù)需在請求JSON傳參

請求參數(shù)

參數(shù)名	變量	類型	必填	描述
子商戶號	sub_mchid	string（32）	否	query 子商戶，填寫微信支付分配的商戶號 1. 若商戶是直連商戶、機構/銀行服務商，無需填寫該字段 2. 若商戶是普通服務商商戶，需要填寫該字段示例值：1900000101
結算狀態(tài)	settle_state	string（32）	是	query 資金結算狀態(tài)，枚舉值： SETTLED：已結算 UNSETTLE：未結算示例值：SETTLED
結算開始日期	settle_start_date	string（8）	否	query 1、格式為yyyyMMdd，如2009年12月25日表示為20091225，時區(qū)為GMT+8 beijing 2、當settle_state（結算狀態(tài)）為SETTLED時，該字段必填；示例值：20091225
結算結束日期	settle_end_date	string（8）	否	query 1、格式為yyyyMMdd，如2009年12月25日表示為20091226，時區(qū)為GMT+8 beijing 2、當settle_state（結算狀態(tài)）=SETTLED時，該字段必填； 3、結算結束日期需大于等于結算開始日期示例值：20091226
最大記錄條數(shù)	limit	uint32	是	query 返回的最大記錄條數(shù)，一般不超過10條為佳，系統(tǒng)最大支持30條示例值：5
記錄起始位置	offset	uint32	是	query 該次請求資源的起始位置示例值：10

請求示例：


 https://api.mch.weixin.qq.com/hk/v3/settle/settlements?sub_mchid=190000010&settle_state=SETTLED&settle_start_date=20091225&settle_end_date=20091226&offset=10&limit=5

    
｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

+ 結算信息列表

data

array

是

結算信息的詳情

參數(shù)名

變量

類型[長度限制]

必填

描述

付款批次號

batch_id

string[1,32]

是

微信返回的付款批次號
示例值：20091225003

結算日期

settlement_date

string[1,8]

是

格式為yyyyMMdd，如2009年12月25日表示為20091225。時區(qū)為GMT+8 beijing
示例值：20091225

交易開始日期

trade_start_date

string[1,8]

是

格式為yyyyMMdd，如2009年12月25日表示為20091226。時區(qū)為GMT+8 beijing
示例值：20091225

交易結束日期

trade_end_date

string[1,8]

是

格式為yyyyMMdd，如2009年12月25日表示為20091225。時區(qū)為GMT+8 beijing
示例值：20091225

+ 金額

amount

object

是

指未特殊標記為分賬類的普通跨境收單交易。

參數(shù)名	變量	類型[長度限制]	必填	描述
已結算金額	settled	int	是	交易開始日期到交易結束日期已結算金額匯總，幣種最小單位示例值：123
未結算金額	unsettle	int	是	交易開始日期到交易結束日期未結算金額匯總，幣種最小單位（按日匯總結算，退款金額大于支付金額此值可能為負值計算公式：未結算金額 = 支付金額 - 退款金額 - 手續(xù)費金額）示例值：123
結算幣種	currency	string[3, 3]	是	幣種，符合ISO 4217標準的三位字母代碼示例值：HKD
支付金額	pay	int	是	交易開始日期到交易結束日期支付總金額幣種最小單位示例值：123
退款金額	refund	int	是	交易開始日期到交易結束日期退款總金額幣種最小單位示例值：123
支付凈額	net	int	是	交易開始日期到交易結束日期支付凈額（支付-退款）幣種最小單位（按日匯總結算，退款金額大于支付金額此值可能為負值計算公式：支付凈額 = 支付金額 - 退款金額）示例值：123
手續(xù)費金額	fee	int	是	交易開始日期到交易結束日期手續(xù)費總金額幣種最小單位（按日匯總結算，退款金額大于支付金額此值可能為負值）示例值：123

錢包主體

wallet_region

string

否

日本/中國澳門區(qū)域已經(jīng)開通微信香港錢包的跨境收單商戶，該字段取值如下：
CHINA_MAINLAND：中國大陸錢包
CHINA_HONGKONG：中國香港錢包
其他場景的商戶不返回該字段。
示例值：CHINA_HONGKONG

+ 分賬業(yè)務金額

split_amount

object

否

指已標記為分賬類的跨境收單交易，適用于開通分賬功能的業(yè)務場景。微信支付平臺僅針對特定行業(yè)開放分賬能力（如跨境電商行業(yè)），具體以平臺對外公布的產(chǎn)品信息為準。

參數(shù)名	變量	類型[長度限制]	必填	描述
已結算金額	settled	int	是	交易開始日期到交易結束日期已結算金額匯總幣種最小單位示例值：123
未結算金額	unsettle	int	是	交易開始日期到交易結束日期未結算金額匯總幣種最小單位（按日匯總結算，退款金額大于支付金額此值可能為負值計算公式：未結算金額 = 支付金額 - 退款金額 - 手續(xù)費金額）示例值：123
結算幣種	currency	string[3, 3]	是	幣種，符合ISO 4217標準的三位字母代碼示例值：HKD
支付金額	pay	int	是	交易開始日期到交易結束日期支付總金額幣種最小單位示例值：123
退款金額	refund	int	是	交易開始日期到交易結束日期退款總金額幣種最小單位示例值：123

總記錄條數(shù)

total_count

int

是

資源總條數(shù)。當offset=0或者當前查詢?yōu)榭諘r應該返回總條數(shù)
示例值：1234

記錄起始位置

offset

int

是

示例值：1

本次返回條數(shù)

limit

int

是

示例值：20

返回示例

正常示例


{
  "data": [
    {
      "amount": {
        "currency": "HKD",
        "fee": 123,
        "net": 123,
        "pay": 123,
        "refund": 123,
        "settled": 123,
        "unsettle": 123
      },
      "batch_id": "20091225003",
      "settlement_date": "20091225",
      "split_amount": {
        "currency": "HKD",
        "pay": 123,
        "refund": 123,
        "settled": 123,
        "unsettle": 123
      },
      "trade_end_date": "20091225",
      "trade_start_date": "20091225",
      "wallet_region": "CHINA_HONGKONG"
    }
  ],
  "limit": 20,
  "offset": 1,
  "total_count": 1234
}


http://2323weixin.qq.com

錯誤碼

狀態(tài)碼	錯誤碼	描述	解決方案
500	SYSTEM_ERROR	系統(tǒng)錯誤	系統(tǒng)錯誤，請稍后再試
400	PARAM_ERROR	參數(shù)錯誤	參數(shù)錯誤，請核對參數(shù)后重試
429	FREQUENCY_LIMITED	請求頻率過高	請求頻率過高，請稍后重試
404	RESOURCE_NOT_EXISTS	記錄不存在	記錄不存在，請調整參數(shù)后重試

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

公眾號支付

查詢結算資金明細API

注意：

接口說明

請求參數(shù)

請求示例：

返回參數(shù)

返回示例

錯誤碼

版本說明