FINGER TRADER

brokerageDocsPage.customers

客戶管理 API

經紀商端客戶列表、開戶申請、審核操作、客戶歸屬、在線狀態及客戶畫像 API。

文檔架構 · 概覽

認證與存取權限

這些介面需要已授權的經紀商/商戶員工會話及相應後端權限;一般終端客戶交易 App Token 無法用於此處。請向券商管理員確認權限。

向所選商戶 BFF 環境發送 JSON POST 請求。Finger Admin 用戶端會在 Authorization 請求標頭中傳送已登入的經紀商員工 Access Token,格式為 Bearer Token。

https://dev-api.fingertrading.com/finger-bff-merchant
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.

POST/mer-api/v1/customer/list

請求範例

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

請求欄位

pagenumber
pageSizenumber
queryobject

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 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.

POST/mer-api/v1/customer/open-account-list

請求範例

{
  "page": 1,
  "pageSize": 20,
  "query": {
    "userNumber": "",
    "brokerNumber": "",
    "marketType": 0,
    "startTime": "",
    "endTime": ""
  }
}

請求欄位

pagenumber
pageSizenumber
queryobject

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 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.

POST/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.

POST/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.

POST/mer-api/v1/customer/submit-review

請求範例

{
  "id": "demo-application-id",
  "approved": true,
  "stageCode": "ACCOUNT_OPENING",
  "proveImage": "",
  "remark": "Reviewed",
  "failField": {}
}

請求欄位

idstring
approvedboolean
stageCodestring
proveImagestring
remarkstring
failFieldobject

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 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.

POST/mer-api/v1/customer/set-owner

請求範例

{
  "userId": "demo-user-id",
  "bcId": "demo-owner-id"
}

請求欄位

userIdstring
bcIdstring

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 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.

POST/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.

POST/mer-api/v1/customer/portrait/overview

請求範例

{
  "id": "demo-user-id",
  "startDate": "2026-01-01",
  "endDate": "2026-01-31",
  "marketType": 0,
  "favoriteTickerLimit": 10,
  "performanceOrderLimit": 20
}

請求欄位

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 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.

POST/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
}

請求欄位

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

回應範例

範例值僅供說明,請替換為授權帳戶取得的識別碼。回應本文結構是依 Finger Admin 用戶端使用方式模擬,確切規格請向券商確認。配置及訂單操作可能變更實際資料。

{
  "code": 0,
  "data": [
    {
      "date": "2026-01-01",
      "orderCount": 0,
      "pnl": "0"
    }
  ],
  "msg": "success"
}
試用此請求 · /mer-api/v1/customer/portrait/order-performance

就緒。按下「發送請求」前不會送出請求。

回應
—

本頁只在目前頁面工作階段暫存 Token,不會保存。請勿在共用裝置上使用,完成後清除 Token。