مرجع API

خيارات دفع الحملة

يسرد أسماء وسائل الدفع المفعلة لبلد بيع الحملة المعتمدة وعملتها وسياق العميل دون أسرار المزودين.

GEThttps://api.sparkglim.net/api/public/payment-methods/:campaignId

نموذج الوصول

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

افتح رابط الدفع المعاد؛ ويتحكم SparkGlim Server في الأسعار والوسائل والتحقق والتنفيذ، والعودة مجرد تنقل.

الاسم	النوع	التحقق من المدخلات
`campaignId`مطلوب سجل حملة قائم ضمن حساب الطالب وأي نطاق أضيق لمفتاح الحملة.	`string`	التحقق: UUID أو معرّف مورد موثّق.
`app_type`اختياري سياق العميل القائم لاختيار تهيئة الويب أو التطبيق؛ ولا يمنح صلاحيات إضافية.	`enum`	التحقق: user_app إذا اختاره المستخدم؛ وإلا web.

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

GET /api/public/payment-methods/:campaignId

http

GET /api/public/payment-methods/11111111-1111-4111-8111-111111111111 HTTP/1.1
Host: api.sparkglim.net

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

json

{
  "success": true,
  "data": {
    "methods": [],
    "currency": "GHS",
    "country": "GH"
  }
}

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

json

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

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

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

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