跳至主要内容

主賬戶接口

獲取主賬戶詳情​

POST /abc/v1/account/detail

取得主賬戶的基本資料、賬戶狀態及資金餘額資訊。

請求頭​

X-API-Key
string
範例
{apiKey}
X-Timestamp
integer
範例
{{Timestamp}}
X-Nonce
string
範例
{{Nonce}}
X-Signature
string
範例
{{Signature}}
Content-Type
string
範例
application/json

請求體​

文件未定義請求體結構。

成功響應​

數據模型：CommonResultOpenAccountResponse

響應欄位​

code
integer
說明
錯誤碼
msg
string
說明
錯誤提示，用戶可閱讀
message
string
查看子欄位
parentAccountId
string
說明
主賬戶唯一編號
parentAccountName
string
說明
主賬戶名稱
accountStatus
integer
說明
賬戶狀態
可選值：
1正常
2掛失
3註銷
4休眠
availableAmount
number
說明
可用餘額，單位：分(cent)
frozenAmount
number
說明
凍結餘額，單位：分(cent)
bookAmount
number
說明
賬面總額，單位：分(cent)
currency
string
說明
幣種（ISO 4217），如 USD
createTime
string
說明
開戶時間

主賬戶管理：賬戶轉賬​

POST /abc/v1/account/transfer

在主賬戶與子賬戶之間，或不同子賬戶之間發起資金劃轉。

請求頭​

X-API-Key
string
範例
{apiKey}
X-Timestamp
integer
範例
{{Timestamp}}
X-Nonce
string
範例
{{Nonce}}
X-Signature
string
範例
{{Signature}}
Content-Type
string
範例
application/json

請求體​

數據模型：OpenAccountTransferRequest

transferInAccountId
string
說明
轉入賬戶編號
transferInIsParentAccount
boolean
說明
轉入賬戶是否是主賬戶
transferOutAccountId
string
說明
轉出賬戶唯一編號
transferOutIsParentAccount
boolean
說明
轉出賬戶是否是主賬戶
transferAmount
number
說明
轉賬金額

成功響應​

數據模型：CommonResultBoolean

響應欄位​

code
integer
說明
錯誤碼
msg
string
說明
錯誤提示，用戶可閱讀
message
string
data
boolean
說明
返回數據

獲取充值地址​

POST /abc/v1/account/recharge-address

取得主賬戶的充值地址，用於後續入金操作。

請求頭​

X-API-Key
string
範例
{apiKey}
X-Timestamp
integer
範例
{{Timestamp}}
X-Nonce
string
範例
{{Nonce}}
X-Signature
string
範例
{{Signature}}
Content-Type
string
範例
application/json

請求體​

文件未定義請求體結構。

成功響應​

數據模型：CommonResultOpenRechargeAddressResponse

響應欄位​

code
integer
說明
錯誤碼
msg
string
說明
錯誤提示，用戶可閱讀
message
string
查看子欄位
address
string
說明
商戶充值地址；商戶尚未開通錢包時爲 null
minRechargeAmount
number
說明
最小充值金額，單位：分(cent/minor unit)；低於該金額的入金不予入賬

查詢主賬戶資金流水​

POST /abc/v1/account/flow/query

根據篩選條件分頁查詢主賬戶的資金變動記錄。

請求頭​

X-API-Key
string
範例
{apiKey}
X-Timestamp
integer
範例
{{Timestamp}}
X-Nonce
string
範例
{{Nonce}}
X-Signature
string
範例
{{Signature}}
Content-Type
string
範例
application/json

請求體​

數據模型：OpenAccountFlowQueryRequest

pageNo
integer必填
說明
頁碼，從 1 開始
範圍：≥1
默認值：1
範例：1
pageSize
integer必填
說明
每頁條數，最大值爲 200
範圍：≥1
默認值：10
範例：10
accountFlowId
string
說明
資金賬戶交易流水編號
範例 / 默認值
2108839919989616642
parentAccountId
string
說明
主賬戶編號
範例 / 默認值
210945783621084760203
currency
string
說明
幣種編碼 ISO 4217
範例 / 默認值
USD
transTypes
數組<integer>
說明
交易類型數組（單類型查詢傳一個元素）
可選值：
1自助充值
2轉出
3轉入
4費用扣減
6人工充值
7調增
8調減
9退款
元素數量：1–8
rechargeMethod
integer
說明
充值方式（僅充值類交易有值）
可選值：
1USD轉賬
5USDT轉賬
6返點轉充值
7餘額轉移
8調賬
範例：5
transStatus
integer
說明
交易狀態
可選值：
1成功
2失敗
3待處理
4處理中
範圍：1–4
範例：1
transactionTime
數組<string>
說明
交易時間區間：[開始時間, 結束時間]
元素數量：2

成功響應​

數據模型：CommonResultPageResultOpenAccountFlowResponse

響應欄位​

code
integer
說明
錯誤碼
msg
string
說明
錯誤提示，用戶可閱讀
message
string
查看子欄位
total
integer (int64)
說明
總量
list
數組<對象（OpenAccountFlowResponse）>
說明
數據

查詢充值明細​

POST /abc/v1/account/recharge/query

分頁查詢主賬戶的充值記錄及其處理狀態。

請求頭​

X-API-Key
string
範例
{apiKey}
X-Timestamp
integer
範例
{{Timestamp}}
X-Nonce
string
範例
{{Nonce}}
X-Signature
string
範例
{{Signature}}
Content-Type
string
範例
application/json

請求體​

數據模型：OpenRechargeFlowQueryRequest

pageNo
integer必填
說明
頁碼，從 1 開始
範圍：≥1
默認值：1
範例：1
pageSize
integer必填
說明
每頁條數，最大值爲 200
範圍：≥1
默認值：10
範例：10
accountFlowId
string
說明
資金賬戶交易流水編號
範例 / 默認值
2108839919989616642
parentAccountId
string
說明
主賬戶編號
範例 / 默認值
210945783621084760203
currency
string
說明
幣種編碼 ISO 4217
範例 / 默認值
USD
transTypes
數組<integer>必填
說明
交易類型數組
可選值：
1自助充值
2轉出
3轉入
4費用扣減
6人工充值
7調增
8調減
9退款
元素數量：≤8
rechargeMethod
integer
說明
充值方式
可選值：
1USD轉賬
5USDT轉賬
6返點轉充值
7餘額轉移
8調賬
範例：5
transStatus
integer
說明
交易狀態
可選值：
1成功
2失敗
3待處理
4處理中
範圍：1–4
範例：1
transactionTime
數組<string>
說明
交易時間區間：[開始時間, 結束時間]
元素數量：2

成功響應​

數據模型：CommonResultPageResultOpenAccountFlowResponse

響應欄位​

code
integer
說明
錯誤碼
msg
string
說明
錯誤提示，用戶可閱讀
message
string
查看子欄位
total
integer (int64)
說明
總量
list
數組<對象（OpenAccountFlowResponse）>
說明
數據