brokerageDocsPage.customers
客戶管理 API
經紀商端客戶列表、開戶申請、審核操作、客戶歸屬、在線狀態及客戶畫像 API。
認證與存取權限
這些介面需要已授權的經紀商/商戶員工會話及相應後端權限;一般終端客戶交易 App Token 無法用於此處。請向券商管理員確認權限。
向所選商戶 BFF 環境發送 JSON POST 請求。Finger Admin 用戶端會在 Authorization 請求標頭中傳送已登入的經紀商員工 Access Token,格式為 Bearer Token。
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
本分類介面
Customer records, account opening reviews, account ownership, status, and customer profile endpoints used by Finger Admin.
Customer list
Paged customer search; query keys are based on UserQueryDTO.
/mer-api/v1/customer/list請求範例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}請求欄位
pagenumberpageSizenumberqueryobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/customer/list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Open account applications
Paged account-opening application list.
/mer-api/v1/customer/open-account-list請求範例
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}請求欄位
pagenumberpageSizenumberqueryobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"total": 1,
"items": [
{
"id": "sample-id",
"userNumber": "U10001",
"status": 1
}
]
},
"msg": "success"
}試用此請求 · /mer-api/v1/customer/open-account-list
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Customer detail
Loads a customer record using IDDTO.
/mer-api/v1/customer/detail請求範例
{
"id": "demo-record-id"
}請求欄位
idstring回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"id": "sample-id",
"status": 1
},
"msg": "success"
}試用此請求 · /mer-api/v1/customer/detail
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Open account detail
Loads account-opening application details.
/mer-api/v1/customer/get-open-detail請求範例
{
"id": "demo-record-id"
}請求欄位
idstring回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"id": "sample-id",
"status": 1
},
"msg": "success"
}試用此請求 · /mer-api/v1/customer/get-open-detail
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Review account application
Submits the review decision, stage, remark, and optional failure fields.
/mer-api/v1/customer/submit-review請求範例
{
"id": "demo-application-id",
"approved": true,
"stageCode": "ACCOUNT_OPENING",
"proveImage": "",
"remark": "Reviewed",
"failField": {}
}請求欄位
idstringapprovedbooleanstageCodestringproveImagestringremarkstringfailFieldobject回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": true,
"msg": "success"
}試用此請求 · /mer-api/v1/customer/submit-review
此介面會修改經紀商資料或訂單狀態。Try 會發送真實請求,並非模擬;請使用核準的測試帳戶及環境。
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Assign customer owner
Sets the customer owner/BC assignment.
/mer-api/v1/customer/set-owner請求範例
{
"userId": "demo-user-id",
"bcId": "demo-owner-id"
}請求欄位
userIdstringbcIdstring回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": true,
"msg": "success"
}試用此請求 · /mer-api/v1/customer/set-owner
此介面會修改經紀商資料或訂單狀態。Try 會發送真實請求,並非模擬;請使用核準的測試帳戶及環境。
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Customer online status
Queries online status for a customer.
/mer-api/v1/customer/online-status請求範例
{
"id": "demo-record-id"
}請求欄位
idstring回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"id": "sample-id",
"status": 1
},
"msg": "success"
}試用此請求 · /mer-api/v1/customer/online-status
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Customer portrait overview
CustomerPortraitQueryDTO; available profile metrics depend on backend response data.
/mer-api/v1/customer/portrait/overview請求範例
{
"id": "demo-user-id",
"startDate": "2026-01-01",
"endDate": "2026-01-31",
"marketType": 0,
"favoriteTickerLimit": 10,
"performanceOrderLimit": 20
}請求欄位
idstringstartDatestringendDatestringmarketTypenumberfavoriteTickerLimitnumberperformanceOrderLimitnumber回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": {
"id": "sample-id",
"status": 1
},
"msg": "success"
}試用此請求 · /mer-api/v1/customer/portrait/overview
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。
Customer order performance portrait
Queries the customer order-performance portrait.
/mer-api/v1/customer/portrait/order-performance請求範例
{
"id": "demo-user-id",
"startDate": "2026-01-01",
"endDate": "2026-01-31",
"marketType": 0,
"favoriteTickerLimit": 10,
"performanceOrderLimit": 20
}請求欄位
idstringstartDatestringendDatestringmarketTypenumberfavoriteTickerLimitnumberperformanceOrderLimitnumber回應範例
範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。
{
"code": 0,
"data": [
{
"date": "2026-01-01",
"orderCount": 0,
"pnl": "0"
}
],
"msg": "success"
}試用此請求 · /mer-api/v1/customer/portrait/order-performance
就緒。按下「發送請求」前不會送出請求。
回應—
本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。