FINGER TRADER

brokerageDocsPage.customers

واجهات إدارة العملاء API

واجهات الوسيط لقوائم العملاء وطلبات الحساب والمراجعة وتعيين المسؤول وحالة الاتصال وملفات العملاء.

إطار الوثائق · نظرة عامة

المصادقة وصلاحيات الوصول

تتطلب هذه الواجهات جلسة موظف وسيط موثقة وصلاحيات backend المناسبة. لا يصادق Token مستخدم تطبيق التداول العادي على هذه الواجهات. تحقق من الصلاحيات مع مسؤول الوسيط.

أرسل طلبات POST بصيغة JSON إلى بيئة Merchant BFF المحددة. يرسل عميل Finger Admin رمز وصول موظف الوسيط المسجل بصيغة Bearer ضمن ترويسة Authorization.

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

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 بعد الانتهاء.