brokerageDocsPage.customers
API จัดการลูกค้า
API ฝั่งโบรกเกอร์สำหรับรายชื่อลูกค้า ใบสมัครเปิดบัญชี การตรวจสอบ การมอบหมาย สถานะออนไลน์ และข้อมูลลูกค้า
การยืนยันตัวตนและสิทธิ์เข้าถึง
ต้องใช้เซสชันพนักงานโบรกเกอร์/ร้านค้าที่ผ่านการยืนยันตัวตนและสิทธิ์ backend ที่เกี่ยวข้อง Token ของผู้ใช้แอปซื้อขายทั่วไปใช้ยืนยันตัวตนที่นี่ไม่ได้ โปรดยืนยันสิทธิ์กับผู้ดูแลโบรกเกอร์
ส่งคำขอ POST แบบ JSON ไปยังสภาพแวดล้อม Merchant BFF ที่เลือก Finger Admin ส่ง Access Token ของพนักงานโบรกเกอร์ที่เข้าสู่ระบบในส่วนหัว Authorization ในรูปแบบ Bearer
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.
/mer-api/v1/customer/listตัวอย่างคำขอ
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}ฟิลด์คำขอ
pagenumberpageSizenumberqueryobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.
/mer-api/v1/customer/open-account-listตัวอย่างคำขอ
{
"page": 1,
"pageSize": 20,
"query": {
"userNumber": "",
"brokerNumber": "",
"marketType": 0,
"startTime": "",
"endTime": ""
}
}ฟิลด์คำขอ
pagenumberpageSizenumberqueryobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.
/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.
/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.
/mer-api/v1/customer/submit-reviewตัวอย่างคำขอ
{
"id": "demo-application-id",
"approved": true,
"stageCode": "ACCOUNT_OPENING",
"proveImage": "",
"remark": "Reviewed",
"failField": {}
}ฟิลด์คำขอ
idstringapprovedbooleanstageCodestringproveImagestringremarkstringfailFieldobjectตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.
/mer-api/v1/customer/set-ownerตัวอย่างคำขอ
{
"userId": "demo-user-id",
"bcId": "demo-owner-id"
}ฟิลด์คำขอ
userIdstringbcIdstringตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.
/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.
/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ตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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.
/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ตัวอย่างการตอบกลับ
ค่าเป็นตัวอย่าง โปรดแทนรหัสด้วยค่าจากบัญชีที่ได้รับสิทธิ์ โครงสร้างการตอบกลับเป็นตัวอย่างที่อนุมานจากการใช้งาน 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 เมื่อเสร็จแล้ว