توثيق واجهة Kripicard: كل ما تحتاجه قبل أول طلب.
هذه الصفحة هي المدخل العربي إلى توثيق واجهة Kripicard البرمجية: كيف تحصل على المفتاح، كيف تحميه، ما العمليات التي تغطيها الواجهة، وكيف تتعامل مع الأحداث. أما المرجع الكامل لنقاط النهاية فيُعرض داخل لوحة التحكم ليبقى متزامنًا مع الإصدار الفعلي.
لماذا المرجع الكامل داخل لوحة التحكم؟
نقاط النهاية وأسماء الحقول تتطوّر، والتوثيق المنشور خارج المنتج يتقادم بسرعة. لذلك يُعرض المرجع التفصيلي — المسارات، المعاملات، أشكال الاستجابة، رموز الأخطاء — داخل لوحة التحكم، مرتبطًا بالإصدار الذي يعمل عليه حسابك فعلًا.
ما تجده هنا هو المفاهيم الثابتة التي لا تتغيّر بتغيّر الإصدار: نموذج المصادقة، دورة حياة البطاقة، سلوك التمويل، والممارسات التي تحمي تكاملك من الأخطاء الشائعة.
محاور التوثيق
المفاهيم الأساسية التي يبنى عليها أي تكامل.
المصادقة بالمفتاح
كل طلب يحمل مفتاح API خاصًا بحسابك، يُولَّد ويُلغى من الإعدادات.
دورة حياة البطاقة
إنشاء، ضبط الحد، تجميد، إلغاء التجميد، وإغلاق مع إرجاع الرصيد.
الرصيد والتمويل
رصيد USDT واحد يموّل كل البطاقات، ويمكن الاستعلام عنه برمجيًا.
سجل المعاملات
معاملات كل بطاقة على حدة لتسوية الحسابات ونسبة الإنفاق.
Webhooks
إشعارات بالمعاملات والرفض وتغيّر حالة البطاقة إلى عنوان تحدده.
معالجة الأخطاء
رموز واضحة تميّز بين خطأ في الطلب ونقص في الرصيد ورفض من الشبكة.
أين تجد كل معلومة
خريطة سريعة لمصادر التوثيق.
| المعيار | Kripicard | صفحات الأدلة العامة | الدعم الفني |
|---|---|---|---|
| مسارات نقاط النهاية والحقول | لوحة التحكم | لا | عند الحاجة |
| توليد المفاتيح وإلغاؤها | الإعدادات | شرح الخطوات | لا |
| مفاهيم دورة حياة البطاقة | نعم | نعم | نعم |
| أنماط التكامل وإعادة المحاولة | ملخص | دليل مفصّل | استشارة |
| حالات خاصة بحسابك | جزئيًا | لا | نعم |
| الرسوم والحدود | نعم | صفحة الرسوم | نعم |
تستند المقارنة إلى نماذج الإصدار الشائعة في السوق حتى عام 2026. وقد تختلف الشروط والتوافر حسب المزوّد والمنطقة.
الوصول إلى المرجع الكامل
من الحساب إلى أول استجابة ناجحة.
- 01
سجّل الدخول
أو أنشئ حسابًا؛ المستوى الأساسي لا يتطلب KYC.
- 02
افتح الإعدادات
ولّد مفتاح API وخزّنه في مدير أسرار، لا في الكود.
- 03
افتح مرجع الواجهة
داخل اللوحة: المسارات والحقول وأمثلة الطلبات.
- 04
نفّذ طلبًا للقراءة أولًا
استعلم عن الرصيد قبل إنشاء أي بطاقة للتأكد من المصادقة.
ملاحظة قانونية وتنظيمية
Kripicard منصة تقنية تعمل بالشراكة مع جهات إصدار مرخّصة وعلى شبكتَي Visa وMastercard. الوصول إلى الواجهة البرمجية لا يُلغي أي التزام تنظيمي: نطبّق فحوصات مكافحة غسل الأموال وتمويل الإرهاب وفحص العقوبات ومراقبة المعاملات على كل بطاقة تُصدر عبر الـ API، تمامًا كما في لوحة التحكم. المستوى الأساسي لا يتطلب KYC، مع مستويات تحقق أعلى كلما زاد الحجم — وهذا تحقق متدرّج وليس إخفاءً للهوية.
يُمنع استخدام الواجهة لإصدار بطاقات لأطراف في ولايات خاضعة للعقوبات أو لأنشطة تحظرها شبكات البطاقات أو القانون المحلي، وقد يُوقف المفتاح فورًا عند المخالفة. راجع الشروط والأحكام وكيف نتعامل مع الأموال.
أسئلة شائعة عن توثيق الواجهة
قبل أن تكتب سطر الكود الأول.
هل التوثيق متاح بالعربية؟+
أين أجد مسارات نقاط النهاية؟+
ماذا أفعل إذا تسرّب المفتاح؟+
هل يمكنني استخدام أكثر من مفتاح؟+
هل توجد Webhooks؟+
افتح المرجع الكامل داخل لوحة التحكم.
أنشئ حسابًا، ولّد مفتاحًا من الإعدادات، وابدأ بطلب قراءة بسيط.
Explore Kripicard
Discover our complete suite of crypto virtual card solutions and services