واجهة برمجة تطبيقات إصدار البطاقات
2328 هي واجهة برمجة تطبيقات لإصدار البطاقات الافتراضية للفرق التي ترغب في توفير بطاقة دفع لمستخدميها دون أن تصبح جهة إصدار مرخصة. يمكنك تسجيل حاملي البطاقات، وإصدار البطاقات تحت رقم تعريف بنكي (BIN) برعاية، وتمويلها من محفظة USDT الخاصة بك والتحكم في دورة الحياة بأكملها — التجميد، التفريغ، الإغلاق — من خلال واجهة REST واحدة.
إنشاء برنامج بطاقات بالطريقة التقليدية يعني ترخيص مخطط، ورقم تعريف بنكي (BIN)، ومعالج، وبنك راعي، وثمانية عشر شهرًا من أعمال الاعتماد قبل أن يتم أول تفويض. هذا العمل قد تم بالفعل هنا. ما يتبقى من جانبك هو الجزء الذي يمثل منتجك بالفعل: من يحصل على بطاقة، وماذا يمكنه إنفاقه، وكيف تبدو التجربة.
واجهة برمجة التطبيقات (API) هي JSON فقط، وجميع الحقول بصيغة camelCase، وكل طلب باستثناء فحص الصحة العام مصرح به بمفتاح Bearer. المال دائمًا عدد صحيح بوحدات صغيرة مع عملة ومقياس صريحين — المحفظة هي USDT بمقياس 6، والبطاقات هي USD بمقياس 2 — لذلك لا يوجد أبدًا تعويم غامض في دفتر الأستاذ.
حاملو البطاقات
سجل حاملي البطاقات ببيانات الهوية التي يتطلبها البرنامج، ثم أصدر بطاقة واحدة أو عدة بطاقات لكل منهم. يتم التحكم في الإعداد والحدود ودورة الحياة بالكامل من جانبك.
إصدار فوري للبطاقات الافتراضية
يتم إنشاء البطاقات بمكالمة واحدة لواجهة برمجة التطبيقات (API) وتكون قابلة للاستخدام فورًا — لا بلاستيك، لا شحن، لا خطوة تفعيل. أصدر واحدة لكل مستخدم، لكل اشتراك، لكل حملة أو لكل مورد.
التمويل من محفظة USDT
يتم تمويل البطاقات من رصيد عملتك المستقرة. تأتي USDT بمقياس 6، ورصيد البطاقة هو USD بمقياس 2، وواجهة برمجة التطبيقات (API) صريحة بشأن كليهما حتى لا تنجرف دفاتر الأستاذ أبدًا.
تحكم كامل في دورة الحياة
تجميد البطاقات وإلغاء تجميدها وتفريغها وإغلاقها برمجيًا. يمكن إيقاف البطاقة المخترقة بطلب واحد؛ ولا تكلف الاشتراك المنتهي شيئًا لإغلاقه.
الأرصدة والمعاملات
قراءة أرصدة البطاقات الحية وسجل المعاملات عبر البرنامج بأكمله، بما في ذلك التفويضات والتسويات والرفض والرسوم.
الطلبات والخطافات الشبكية (Webhooks)
عمليات الأموال غير متزامنة: تقوم بإرسال عملية، وتتلقى طلبًا، وتتعامل مع الخطاف الشبكي كمصدر للحقيقة بدلاً من افتراض النجاح عند استجابة 200.
رعاية BIN، بدون الالتفاف لمدة عامين
كل بطاقة مرتبطة برقم BIN — وهو الرقم الذي يخبر شبكات البطاقات عن المؤسسة المرخصة التي تقف وراءها. الحصول على رقمك الخاص يعني أن تصبح عضوًا رئيسيًا في Visa أو Mastercard: ترخيص تنظيمي، ضمانات للمخطط، متطلبات رأس المال، وسنوات من الاعتماد.
البطاقات الصادرة من خلال 2328 تعمل على BIN برعاية موجودة. تحتفظ المؤسسة الراعية بعضوية المخطط وتقوم بالتسوية مع الشبكة؛ بينما تحتفظ أنت بالمنتج، والعلامة التجارية، وعلاقة حامل البطاقة، والجوانب الاقتصادية. عمليًا، هذا يحول مشروع الترخيص إلى مشروع تكامل.
عملية الإعداد لا تزال تتطلب عناية حقيقية — سيُطلب منك معرفة من هم حاملو بطاقاتك، ومن أين تأتي الأموال، وكيف تبدو إجراءات KYC والمراقبة لديك. كلما كانت الإجابات أوضح، كلما بدأ البرنامج بشكل أسرع.
كيف تتم عملية التكامل
- 1.الموافقة على البرنامج: ملف تعريف حامل البطاقة، تدفق التمويل، المناطق الجغرافية والحدود.
- 2.الحصول على مفاتيح API والتحقق من الاتصال مقابل نقطة النهاية العامة GET /ping.
- 3.تسجيل أول حامل بطاقة وإصدار بطاقة في البيئة الحية.
- 4.تمويل البطاقة من محفظة USDT الخاصة بك وتأكيد الطلب الناتج عبر الخطاف الشبكي (webhook).
- 5.ربط الأرصدة والمعاملات وعمليات دورة الحياة بمنتجك.
- 6.الانطلاق والتوسع — الإصدار هو مكالمة واحدة، لذا فإن الحجم ليس مشكلة هندسية.
الأسئلة المتكررة
هل أحتاج إلى ترخيص خاص بي أو BIN لإصدار البطاقات؟
لا. يتم إصدار البطاقات تحت BIN برعاية موجودة، لذلك لا تحتاج إلى أن تصبح عضوًا رئيسيًا في Visa أو Mastercard. تصف حاملي بطاقاتك وتدفق التمويل أثناء عملية الإعداد؛ تقع مسؤولية الترخيص وتسوية المخطط على عاتق المؤسسة الراعية.
ما هي طريقة المصادقة التي تستخدمها واجهة برمجة تطبيقات إصدار البطاقات (card issuing API)؟
مصادقة Bearer. يحمل كل طلب باستثناء فحص السلامة العام Authorization: Bearer ck_{keyId}_{secret}. يحدد المفتاح حسابك، لذلك لا يتم تمرير معرفات التاجر أو الحساب في الحمولة. احتفظ بالمفتاح في الواجهة الخلفية الخاصة بك فقط.
كيف يتم تمويل البطاقات؟
من محفظة USDT الخاصة بك داخل 2328. يحول التمويل العملة المستقرة إلى رصيد بطاقة بالدولار الأمريكي. المحفظة هي USDT بمقياس 6 والبطاقات هي USD بمقياس 2 — المبالغ دائمًا أعداد صحيحة بوحدات صغيرة مع عملة ومقياس صريحين.
هل عمليات البطاقة متزامنة؟
عمليات الأموال غير متزامنة. يعيد طلب التمويل أو التفريغ طلبًا تتعقبه حتى الاكتمال، ويؤكد الخطاف الشبكي (webhook) الحالة النهائية. عمليات القراءة مثل الأرصدة والمعاملات متزامنة.
هل هناك بيئة اختبار (sandbox)؟
توجد بيئة حية واحدة — لا توجد مفاتيح بيئة اختبار منفصلة. تتوفر نقطة نهاية عامة GET /ping بدون مصادقة لفحوصات النشاط.
ما الذي يمكن استخدام البطاقات من أجله؟
تغطي البرامج النموذجية الاشتراكات عبر الإنترنت، والإنفاق الإعلاني، ونفقات الموظفين والمتعاقدين، ومدفوعات السوق، والإنفاق الاستهلاكي العام الممول بالعملات المشفرة. يتم الاتفاق على حالات الاستخدام المسموح بها أثناء إعداد البرنامج.