المطورون
واجهة API لمدفوعات العملات المشفرة
ثلاثة طلبات: إنشاء فاتورة، وقراءة حالتها، وقراءة الرصيد. يدفع العميل من صفحة الدفع وتستلم أنت webhook ورصيد USDT.
نقاط النهاية (Endpoints)
| الطريقة | ما الذي تقوم به |
|---|---|
POST /api/v1/payments | إنشاء فاتورة والحصول على رابط صفحة الدفع |
GET /api/v1/payments/{uuid} | الحالة والعنوان ومعرّف المعاملة |
GET /api/v1/wallet | رصيد USDT المتاح والمجمّد |
الرابط الأساسي: https://api.crybit.net · JSON · 60 طلبًا في الدقيقة · المصادقة: ترويستا X-Public-Key وX-Private-Key.
أنشئ فاتورة
الحقلان الوحيدان المطلوبان هما amount وcurrency. مرّر order_id الخاص بك لمطابقة الدفعة بطلب معيّن، وttl_minutes لتحديد مدة الصلاحية.
curl -X POST https://api.crybit.net/api/v1/payments \
-H "X-Public-Key: pk_…" \
-H "X-Private-Key: sk_…" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"amount":1490,"currency":"RUB","order_id":"ORD-1048","purpose":"Order 1048"}'JavaScript
const invoice = await fetch('https://api.crybit.net/api/v1/payments', {
method: 'POST',
headers: {
'X-Public-Key': 'pk_…',
'X-Private-Key': 'sk_…',
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ amount: 1490, currency: 'RUB', order_id: 'ORD-1048' }),
}).then((r) => r.json())
location.href = invoice.callback_url // the payment pageالـ webhooks والودجت (widget)
عند دفع الفاتورة، تستدعي CryBit رابط webhook الخاص بتاجرك حتى تتمكن من تسليم الطلب. ولإبقاء العميل على موقعك، اطلب confirmation من نوع embedded وافتح نموذج الدفع باستخدام سكربت الودجت.
المرجع
FAQ
كيف أُوثّق الطلبات؟
أرسل المفتاح العام في X-Public-Key والمفتاح الخاص في X-Private-Key. كلا الترويستين مطلوب. ويُحدَّد التاجر عبر المفتاح العام، لذا لا حاجة إلى معرّف متجر في الطلب.
هل يوجد وضع اختبار؟
نعم. ينشئ التاجر في وضع الاختبار فواتير تجريبية: تحتوي صفحة الدفع على زر لتحديدها كمدفوعة، ولا تُغيّر رصيدك. بدّل التاجر إلى الوضع الفعلي لقبول تحويلات حقيقية.
ما هي الحدود المسموح بها؟
تقبل واجهة API 60 طلبًا في الدقيقة لكل مفتاح. ويبدأ مبلغ الفاتورة من 0.01، وتتراوح مدة الصلاحية من 5 إلى 1440 دقيقة.
