主賬戶接口

獲取主賬戶詳情

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否

說明

-

範例 / 默認值

-

data

對象（OpenAccountResponse）否

說明

-

範例 / 默認值

-

data 結構（OpenAccountResponse）

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否

說明

-

範例 / 默認值

-

data

對象（OpenRechargeAddressResponse）否

說明

-

範例 / 默認值

-

data 結構（OpenRechargeAddressResponse）

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

pageSize

integer是

說明

每頁條數，最大值爲 200；最小值 1

範例 / 默認值

10

accountFlowId

string否

說明

資金賬戶交易流水編號

範例 / 默認值

PF20260101000001

parentAccountId

string否

說明

主賬戶編號

範例 / 默認值

PA_001

currency

string否

說明

幣種編碼 ISO 4217

範例 / 默認值

USD

transTypes

數組<integer>否

說明

交易類型數組：1=自助充值，2=轉出，3=轉入，4=費用扣減，6=人工充值，7=調增，8=調減，9=退款；單類型查詢傳一個元素

範例 / 默認值

-

rechargeMethod

integer否

說明

充值方式：1=USD轉賬，5=USDT轉賬，6=返點轉充值，7=餘額轉移，8=調賬（僅充值類交易有值）

範例 / 默認值

5

transStatus

integer否

說明

交易狀態：1=成功，2=失敗，3=待處理，4=處理中；最小值 1；最大值 4

範例 / 默認值

1

transactionTime

數組<string>否

說明

交易時間區間，長度爲 2 的數組：[開始時間, 結束時間]

範例 / 默認值

-

成功響應

數據模型：CommonResultPageResultOpenAccountFlowResponse

code

integer否

說明

錯誤碼

範例 / 默認值

-

msg

string否

說明

錯誤提示，用戶可閱讀

範例 / 默認值

-

message

string否

說明

-

範例 / 默認值

-

data

對象（PageResultOpenAccountFlowResponse）否

說明

-

範例 / 默認值

-

data 結構（PageResultOpenAccountFlowResponse）

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

pageSize

integer是

說明

每頁條數，最大值爲 200；最小值 1

範例 / 默認值

10

accountFlowId

string否

說明

資金賬戶交易流水編號

範例 / 默認值

PF20260101000001

parentAccountId

string否

說明

主賬戶編號

範例 / 默認值

PA_001

currency

string否

說明

幣種編碼 ISO 4217

範例 / 默認值

USD

transTypes

數組<integer>是

說明

交易類型數組：1=自助充值，2=轉出，3=轉入，4=費用扣減，6=人工充值，7=調增，8=調減，9=退款

範例 / 默認值

-

rechargeMethod

integer否

說明

充值方式：1=USD轉賬，5=USDT轉賬，6=返點轉充值，7=餘額轉移，8=調賬

範例 / 默認值

5

transStatus

integer否

說明

交易狀態：1=成功，2=失敗，3=待處理，4=處理中；最小值 1；最大值 4

範例 / 默認值

1

transactionTime

數組<string>否

說明

交易時間區間，長度爲 2 的數組：[開始時間, 結束時間]

範例 / 默認值

-

成功響應

數據模型：CommonResultPageResultOpenAccountFlowResponse

code

integer否

說明

錯誤碼

範例 / 默認值

-

msg

string否

說明

錯誤提示，用戶可閱讀

範例 / 默認值

-

message

string否

說明

-

範例 / 默認值

-

data

對象（PageResultOpenAccountFlowResponse）否

說明

-

範例 / 默認值

-

data 結構（PageResultOpenAccountFlowResponse）

total

integer (int64)否

說明

總量

範例 / 默認值

-

list

數組<對象（OpenAccountFlowResponse）>否

說明

數據

範例 / 默認值

-