微信支付境外文檔-結算資金查詢

返回上一層結算資金查詢對外 / 查詢結算資金明細API

查詢結算資金明細API

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

商戶在交易完結之后，可按結算日期查詢已結算資金明細（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指該參數為路徑參數

query 指該參數需在請求JSON傳參

請求參數

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

返回參數

正常返回

參數名

變量

類型

必填

描述

+ 結算信息列表

data

array

否

結算信息的詳情

參數名

變量

類型

必填

描述

付款批次號

batch_id

string（32）

是

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

結算日期

settlement_date

string（8）

是

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

交易開始日期

trade_start_date

string（8）

是

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

交易結束日期

trade_end_date

string（8）

是

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

+ 金額

amount

object

是

結算金額信息

參數名	變量	類型	必填	描述
已結算金額	settled	int	是	交易開始日期到交易結束日期已結算金額匯總，外幣標價，外幣最小單位示例值：123
未結算金額	unsettle	int	是	交易開始日期到交易結束日期未結算金額匯總，外幣標價，外幣最小單位示例值：123
結算幣種	currency	string（32）	是	幣種，符合ISO 4217標準的三位字母代碼示例值：HKD
支付金額	pay	int	是	交易開始日期到交易結束日期支付總金額，外幣標價，外幣最小單位示例值：123
退款金額	refund	int	是	交易開始日期到交易結束日期退款總金額，外幣標價，外幣最小單位示例值：123
支付凈額	net	int	是	交易開始日期到交易結束日期支付凈額（支付-退款），外幣標價，外幣最小單位示例值：5
手續(xù)費金額	fee	int	是	交易開始日期到交易結束日期手續(xù)費總金額，外幣標價，外幣最小單位示例值：5

錢包主體

wallet_region

string（32）

否

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

總記錄條數

total_count

int

是

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

記錄起始位置

offset

int

是

本次查詢的起始位置
示例值：1

本次返回條數

limit

int

是

返回本次查詢到的條數
示例值：20

返回示例：

正常示例

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

錯誤碼

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

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

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

結算資金查詢對外 API

查詢結算資金明細API

注意：

接口說明

請求參數

請求示例：

返回參數

正常返回

返回示例：

錯誤碼

版本說明