brokerageDocsPage.customers
واجهات إدارة العملاء API
واجهات الوسيط لقوائم العملاء وطلبات الحساب والمراجعة وتعيين المسؤول وحالة الاتصال وملفات العملاء.
المصادقة وصلاحيات الوصول
تتطلب هذه الواجهات جلسة موظف وسيط موثقة وصلاحيات backend المناسبة. لا يصادق Token مستخدم تطبيق التداول العادي على هذه الواجهات. تحقق من الصلاحيات مع مسؤول الوسيط.
أرسل طلبات POST بصيغة JSON إلى بيئة Merchant BFF المحددة. يرسل عميل Finger Admin رمز وصول موظف الوسيط المسجل بصيغة Bearer ضمن ترويسة Authorization.
Authorization: Bearer <BROKER_STAFF_ACCESS_TOKEN>
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل Finger Admin؛ تحقق من العقد الدقيق مع وسيطك. قد تغيّر طلبات الإعداد أو إجراءات الأوامر بيانات فعلية.
واجهات 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مثال الاستجابة
القيم للتوضيح؛ استبدل المعرّفات بقيم من حسابك المصرح. بنية الاستجابة مثال مستنتج من استخدام عميل 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 بعد الانتهاء.