المطورون

ودجت مضمّن (Embedded widget)

يدفع العميل دون مغادرة نطاق موقعك. تُنشئ الفاتورة عبر API وتعرض نموذج الدفع الخاص بـ CryBit في صفحتك الخاصة.

1. أنشئ فاتورة

استخدم نفس POST /api/v1/payments. ويحتوي الرد دائمًا على confirmation.confirmation_token، الذي يساوي معرّف الفاتورة uuid. وحقل confirmation في الطلب اختياري.

2. حمّل السكربت وأضِف حاوية

HTML

<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>

3. اعرض النموذج

JavaScript

const checkout = new CryBitCheckout({
  confirmation_token: 'INVOICE-UUID',
  return_url: 'https://merchant.example/thanks',
  lang: 'en',
  error_callback: (err) => console.log(err),
})

checkout.render('payment-form').then(() => { /* the form is shown */ })
checkout.on('success', () => { /* status paid: confirm the order by webhook or GET */ })
checkout.on('fail', () => { /* expired, cancelled or refunded */ })
checkout.on('complete', () => checkout.destroy())

نافذة منبثقة

إذا لم توجد حاوية في الصفحة، افتح الودجت فوق الموقع بالتخصيص: { modal: true } (أو modal: true) واستدعِ checkout.render() دون أي وسائط.

الخيارات والأحداث

الخيار	المعنى
`confirmation_token`	مطلوب. معرّف الفاتورة uuid (الأسماء البديلة: uuid وinvoice_uuid).
`return_url`	الوجهة التي ينتقل إليها العميل بعد الدفع.
`lang`	لغة الواجهة؛ وإلا فتُستخدم لغة المتصفح.
`modal / customization.modal`	true لعرض نافذة منبثقة بدلًا من حاوية.
`error_callback, success_callback`	تُستدعى عند حدوث خطأ (بلا رمز token أو بلا حاوية) وعندما تصبح الحالة paid.

الأحداث: ready وstatus وsuccess وfail وcomplete وclose وerror. الوسائل (methods): render(id) وon(event, fn) وdestroy().

أكِّد الطلب عبر webhook أو بقراءة الحالة. أما حدث الودجت فهو لواجهة المستخدم فقط.

FAQ

هل يمكنني اختبار الودجت؟

نعم. في حساب تاجر تجريبي، يعرض الودجت زرًا لتحديد الفاتورة كمدفوعة، ولا يُضاف أي مبلغ إلى الرصيد.

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

إنشاء حساب