FINGER TRADER

brokerageDocsPage.customers

API quản lý khách hàng

API phía broker cho danh sách khách hàng, hồ sơ mở tài khoản, xét duyệt, phân công, trạng thái trực tuyến và hồ sơ khách hàng.

Khung tài liệu · Tổng quan

Xác thực và quyền truy cập

Các giao diện này yêu cầu phiên nhân viên broker/merchant đã xác thực và quyền backend tương ứng. Token của người dùng cuối ứng dụng giao dịch thông thường không dùng được. Hãy xác nhận quyền với quản trị viên broker.

Gửi yêu cầu POST JSON đến môi trường Merchant BFF đã chọn. Finger Admin gửi Access Token của nhân viên broker đã đăng nhập trong header Authorization theo dạng Bearer.

https://dev-api.fingertrading.com/finger-bff-merchant
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

API trong mục này

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

Ví dụ yêu cầu

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

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Open account applications

Paged account-opening application list.

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

Ví dụ yêu cầu

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

Trường yêu cầu

pagenumber
pageSizenumber
queryobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "total": 1,
    "items": [
      {
        "id": "sample-id",
        "userNumber": "U10001",
        "status": 1
      }
    ]
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/open-account-list

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Customer detail

Loads a customer record using IDDTO.

POST/mer-api/v1/customer/detail

Ví dụ yêu cầu

{
  "id": "demo-record-id"
}

Trường yêu cầu

idstring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/detail

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Open account detail

Loads account-opening application details.

POST/mer-api/v1/customer/get-open-detail

Ví dụ yêu cầu

{
  "id": "demo-record-id"
}

Trường yêu cầu

idstring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/get-open-detail

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Review account application

Submits the review decision, stage, remark, and optional failure fields.

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

Ví dụ yêu cầu

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

Trường yêu cầu

idstring
approvedboolean
stageCodestring
proveImagestring
remarkstring
failFieldobject

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/submit-review

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Assign customer owner

Sets the customer owner/BC assignment.

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

Ví dụ yêu cầu

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

Trường yêu cầu

userIdstring
bcIdstring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": true,
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/set-owner

Endpoint này thay đổi dữ liệu broker hoặc trạng thái lệnh. Try gửi yêu cầu thật, không phải mô phỏng. Chỉ dùng tài khoản và môi trường kiểm thử được phê duyệt.

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Customer online status

Queries online status for a customer.

POST/mer-api/v1/customer/online-status

Ví dụ yêu cầu

{
  "id": "demo-record-id"
}

Trường yêu cầu

idstring

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/online-status

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Customer portrait overview

CustomerPortraitQueryDTO; available profile metrics depend on backend response data.

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

Ví dụ yêu cầu

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

Trường yêu cầu

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": {
    "id": "sample-id",
    "status": 1
  },
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/portrait/overview

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.

Customer order performance portrait

Queries the customer order-performance portrait.

POST/mer-api/v1/customer/portrait/order-performance

Ví dụ yêu cầu

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

Trường yêu cầu

idstring
startDatestring
endDatestring
marketTypenumber
favoriteTickerLimitnumber
performanceOrderLimitnumber

Ví dụ phản hồi

Giá trị chỉ để minh họa; hãy thay mã bằng dữ liệu từ tài khoản được cấp quyền. Cấu trúc phản hồi là ví dụ suy ra từ cách Finger Admin sử dụng API; hãy xác nhận hợp đồng chính xác với broker. Yêu cầu cấu hình hoặc thao tác lệnh có thể thay đổi dữ liệu thật.

{
  "code": 0,
  "data": [
    {
      "date": "2026-01-01",
      "orderCount": 0,
      "pnl": "0"
    }
  ],
  "msg": "success"
}
Thử yêu cầu này · /mer-api/v1/customer/portrait/order-performance

Sẵn sàng. Yêu cầu chưa được gửi cho đến khi bạn nhấn Gửi.

Phản hồi
—

Token chỉ được giữ trong phiên trang hiện tại và không được lưu bởi trang tài liệu. Tránh dùng thiết bị chung và xóa Token sau khi xong.