مرجع API

تهيئة وسيلة دفع معتمدة

ينشئ تهيئة وسيلة دفع للموزع ضمن الصلاحية وسياسة الموافقة؛ ولا يفعّل مزودين عشوائيين.

POSThttps://api.sparkglim.net/api/white-label/portal/reseller/payment-methods

نموذج الوصول

نموذج الوصول: جلسة SparkGlim وصلاحيات العضو
الصلاحية المطلوبة: payments:write
التوفر الموثّق: منفذ في المصدر

التوفر موثق من المصدر وليس ضمانًا لتشغيل الإنتاج.

استخدم مسار أعضاء فريق المنشئ؛ ولا تمنح إعادة البيع وصولًا غير محدود للبيانات أو الإدارة.

الترويسات

الاسم	النوع	التحقق من المدخلات
`Authorization`مطلوب جلسة SparkGlim حاملة قائمة؛ وتحدد عضوية الحساب والصلاحيات المعينة السماح بكل عملية.	`string`	التحقق: رمز Bearer لجلسة مصادقة موجودة.

الطلب

الاسم	النوع	التحقق من المدخلات
`providerType`مطلوب تهيئة وسيلة دفع موزع معتمدة؛ وتبقى تفاصيل المزود الحساسة محمية بالخادم.	`enum`	التحقق: paystack \| expresspay \| hubtel \| manual.
`methodType`مطلوب تهيئة وسيلة دفع موزع معتمدة؛ وتبقى تفاصيل المزود الحساسة محمية بالخادم.	`enum`	التحقق: bank \| mobile_money \| card \| wallet.
`ownerMemberId`اختياري سجل علاقة أو مراجعة قائم ضمن الحساب؛ ويتحقق الخادم من الملكية والصلاحيات اللازمة.	`string\|null`	التحقق: UUID.
`ownerCreatorId`اختياري سجل علاقة أو مراجعة قائم ضمن الحساب؛ ويتحقق الخادم من الملكية والصلاحيات اللازمة.	`string\|null`	التحقق: UUID.
`label`اختياري تهيئة وسيلة دفع موزع معتمدة؛ وتبقى تفاصيل المزود الحساسة محمية بالخادم.	`string\|null`	التحقق: <=120.
`publicDetails`اختياري تهيئة وسيلة دفع موزع معتمدة؛ وتبقى تفاصيل المزود الحساسة محمية بالخادم.	`object`	التحقق: كائن JSON.
`encryptedDetails`اختياري تهيئة وسيلة دفع موزع معتمدة؛ وتبقى تفاصيل المزود الحساسة محمية بالخادم.	`object`	التحقق: إعدادات محمية في الخادم؛ لا تنشر بيانات الاعتماد مطلقًا.
`metadata`اختياري بيانات JSON إضافية يقبلها المخطط؛ ولا تتجاوز التفويض أو الأسعار أو الملكية.	`object`	التحقق: كائن JSON.

الطلب

تصف الأمثلة العقد ولا تُنفذ. استخدم سجلات اختبار مصرحًا بها، ولا تلصق أسرارًا حقيقية في هذه الصفحات.

POST /api/white-label/portal/reseller/payment-methods

http

POST /api/white-label/portal/reseller/payment-methods HTTP/1.1
Host: api.sparkglim.net
Authorization: Bearer <EXISTING_SESSION_TOKEN>
Content-Type: application/json

{
  "providerType": "manual",
  "methodType": "bank",
  "label": "Example approved method"
}

الاستجابة

استجابة النجاح · HTTP 201

json

{
  "success": true,
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "status": "pending"
  }
}

استجابة الخطأ · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

تستخدم أخطاء التحقق والصلاحيات والموارد والأعطال حالة HTTP وبنية الخطأ الخاصة بالمعالج.

الحدود وإعادة المحاولة

الحد الافتراضي: 100 طلب لكل عنوان IP خلال 60 ثانية، مع ضوابط إضافية حسب المورد.

توافق المصدر

تتطلب العمليات المصرح بها اختبارًا خاصًا بالحساب.

server/src/api/router.ts
server/src/api/routes/white-label.ts
server/src/white-label/reseller-service.ts
server/src/white-label/schemas.ts

نموذج الوصول

الترويسات

الطلب

الطلب

الاستجابة

الحدود وإعادة المحاولة

توافق المصدر

تابع التطوير