المطورون

أنشئ فاتورة

يُنشئ طلب POST واحد فاتورة ويعيد رابط صفحة الدفع. ويختار العميل العملة والشبكة هناك.

الطلب

curl

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"}'

الحقل	المعنى
`amount`	مطلوب. رقم ابتداءً من 0.01. ويوجد حد أدنى بعملة USDT لأن رسوم الشبكة لا يمكن أن تتجاوز قيمة الفاتورة عندما يدفعها التاجر: استعلم عبر GET /api/payments/quote لمعرفة الحد الأدنى الحالي.
`currency`	مطلوب. عملة ورقية (RUB أو USD أو EUR أو CNY أو GBP أو CHF أو JPY أو KZT وغيرها من العملات الرئيسية) أو USDT/USDC. يُحوَّل المبلغ وفق السعر اللحظي.
`order_id`	معرّف طلبك الخاص، بحد أقصى 80 حرفًا. وإذا تُرك فارغًا، تولّد CryBit معرّفًا بالصيغة CB-….
`purpose`	الوصف، بحد أقصى 240 حرفًا.
`ttl_minutes`	مدة الصلاحية من 5 إلى 1440 دقيقة، و30 دقيقة افتراضيًا.
`return_url`	المكان الذي يعود إليه العميل بعد الدفع (http أو https، بحد أقصى 500 حرف). ويُستخدم رابط العودة الخاص بالتاجر في حال عدم تحديده.
`crypto, network`	اختياري. مرّر كليهما للحصول على العنوان والمبلغ ورمز QR في الرد دفعة واحدة، على سبيل المثال USDT وTRC-20.
`confirmation`	اختياري. {"type":"embedded"} للودجت المضمّن. ويكون الرمز (token) موجودًا في الرد دائمًا.

الرد

الرد هو 201 مع كائن الفاتورة. أرسل العميل إلى callback_url (صفحة الدفع). وفي حال عدم تحديد crypto وnetwork، تكون قيمة needs_method صحيحة (true) ويختار العميل من تلك الصفحة.

JSON

{
  "uuid": "28d0ff38-949c-435e-ad41-c81c219b3597",
  "order_id": "ORD-1048",
  "amount": 1490,
  "currency": "RUB",
  "status": "waiting",
  "sandbox": true,
  "needs_method": true,
  "callback_url": "https://pay.crybit.net/28d0ff38-949c-435e-ad41-c81c219b3597",
  "confirmation": { "type": "embedded", "confirmation_token": "28d0ff38-…", "widget_url": "https://pay.crybit.net/widget.js" },
  "expires_at": "2026-09-21T13:41:42+00:00"
}

الحالة

يعيد GET /api/v1/payments/{uuid} الكائن نفسه. وتكون الحالة waiting أو paid أو expired أو cancelled. وبعد أن يختار العميل الشبكة، يحتوي الكائن على crypto وnetwork وaddress والرسوم؛ وبعد الدفع يحتوي على status بقيمة paid وtxid وpaid_at. وتصبح الفاتورة المنتظرة التي تجاوزت مدة صلاحيتها بحالة expired عند الاستعلام عنها. وتكون قيمة fee_payer هي shop عندما يدفع التاجر الرسوم، وbuyer عندما يكون المبلغ المطلوب دفعه شاملًا لها بالفعل.

FAQ

ما الترويسات التي أرسلها؟

X-Public-Key وX-Private-Key، وكلاهما مطلوب. ويؤدي مفتاح خاص مفقود أو خاطئ أو قديم إلى استجابة 401.

هل يوجد حد لمعدل الطلبات؟

60 طلبًا في الدقيقة لكل مفتاح.

احصل على مفتاح API

إنشاء حساب

أنشئ فاتورة

الطلب

الرد

الحالة

FAQ

المزيد

احصل على مفتاح API