FINGER TRADER

brokerageDocsPage.customers

API จัดการลูกค้า

API ฝั่งโบรกเกอร์สำหรับรายชื่อลูกค้า ใบสมัครเปิดบัญชี การตรวจสอบ การมอบหมาย สถานะออนไลน์ และข้อมูลลูกค้า

โครงสร้างเอกสาร · ภาพรวม

การยืนยันตัวตนและสิทธิ์เข้าถึง

ต้องใช้เซสชันพนักงานโบรกเกอร์/ร้านค้าที่ผ่านการยืนยันตัวตนและสิทธิ์ backend ที่เกี่ยวข้อง Token ของผู้ใช้แอปซื้อขายทั่วไปใช้ยืนยันตัวตนที่นี่ไม่ได้ โปรดยืนยันสิทธิ์กับผู้ดูแลโบรกเกอร์

ส่งคำขอ POST แบบ JSON ไปยังสภาพแวดล้อม Merchant BFF ที่เลือก Finger Admin ส่ง Access Token ของพนักงานโบรกเกอร์ที่เข้าสู่ระบบในส่วนหัว Authorization ในรูปแบบ Bearer

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

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

API ในหมวดนี้

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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "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

ตัวอย่างการตอบกลับ

ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน API ของ Finger Admin โปรดยืนยันสัญญา API ที่ถูกต้องกับโบรกเกอร์ คำขอตั้งค่าหรือคำสั่งอาจเปลี่ยนข้อมูลจริง

{
  "code": 0,
  "data": [
    {
      "date": "2026-01-01",
      "orderCount": 0,
      "pnl": "0"
    }
  ],
  "msg": "success"
}
ลองส่งคำขอนี้ · /mer-api/v1/customer/portrait/order-performance

พร้อมใช้งาน คำขอจะยังไม่ถูกส่งจนกว่าจะกดส่ง

การตอบกลับ
—

Token ใช้เฉพาะในเซสชันหน้านี้และเอกสารจะไม่บันทึกไว้ หลีกเลี่ยงอุปกรณ์สาธารณะและล้าง Token เมื่อเสร็จแล้ว