المطورون

واجهة 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 دقيقة.

ذو صلة