نافذة فوق صفحتكقريبًا
تُفتح نافذة الدفع فوق الصفحة الحالية، فيحتفظ العميل بمكانه في السلة.
تُفتح نافذة الدفع فوق صفحتك كنافذة منبثقة، فلا يغادر العميل المتجر أبدًا. نفس منطق الفاتورة في صفحة الدفع المستضافة.
تفتح صفحتك نافذة الدفع بفاتورة أُنشئت عبر API.
يدفع العميل داخل النافذة المنبثقة، دون تحويل.
تصل الحالة النهائية عبر webhook وتُغلق النافذة.
تُفتح نافذة الدفع فوق الصفحة الحالية، فيحتفظ العميل بمكانه في السلة.
المبلغ والأصل والشبكة وسعر الصرف الثابت تعمل تمامًا كما في صفحة الدفع المستضافة.
تأتي حالة الطلب من webhook النهائي، لا من حالة نافذة المتصفح.
يكفي استدعاء سكربت واحد لفتح نافذة الدفع في متجرك.
تقدم Qvard عدة منتجات للدفع. اختر المنتج الذي يناسب قناة البيع لديك.
A quick overview of how Qvard handles payments, integration and merchant operations.
Qvard هو بوابة دفع بالعملات الرقمية للشركات، توفر صفحة دفع مستضافة وفواتير ومدفوعات عبر API وأرصدة للتجار.
يدعم Qvard USDT وUSDC وBTC وLTC وTRX وBNB وETH. TON وUSDT على TON قريبًا.
نعم. يشمل Qvard مدفوعات API وredirectUrl وwebhooks وإعادة المحاولات وسجلات التسليم.
تدعم صفحة الدفع شعار التاجر واسم المتجر ولون الزر والترجمة. روابط العودة المخصصة قريبًا.
أنشئ حساب تاجر وأكمل توثيق النشاط التجاري. بعد تجربة فاتورة تجريبية، اربط صفحة الدفع المستضافة أو API وابدأ باستقبال المدفوعات الحقيقية.
تُتبع الأموال في أرصدة التاجر، منفصلة حسب الأصل والشبكة. يمكنك السحب يدويًا أو إعداد قواعد سحب للدفعات التلقائية.
دمج عنصر واجهة مستخدم الدفع من Qvard بثلاث طرق:
يمكن أن يبقى مفتاحك العام (qvard_pk_…) في كود الصفحة. لا يمكنه سوى إنشاء دفعات لمتجرك—لا يمكنه قراءة البيانات أو سحب الأموال. يعمل فقط من النطاقات في مصادرك المسموحة، وله حد من معدل الطلبات.
هل يحتاج الخادم الخاص بك إلى حساب المبلغ أو فحص المخزون؟ استخدم علامة التبويب "عبر الخادم الخاص بك": يقوم الخادم الخلفي بإنشاء الدفع باستخدام المفتاح السري (qvard_sk_…)، وتذهب URL الدفع فقط إلى المتصفح.
<script src="https://qvard.com/checkout.js"></script> <script> // 1. وصف الدفع var checkout = new QvardCheckout({ mode: 'modal', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, orderId: 'order-123', onSuccess: function (e) { // 3. معالجة النتيجة console.log('paid', e.paymentId); }, onError: function (err) { console.log(err.code); } }); // 2. إنشاء وعرض النافذة checkout.open(); </script>
# إنشاء الدفع على الخادم الخاص بك curl -X POST https://api.qvard.com/api/v1/payment \ -H 'x-api-key: qvard_sk_YOUR_SECRET_KEY' \ -H 'Content-Type: application/json' \ -d '{"price":10,"id":"order-123"}' # الرد: {"id":"...","redirectUrl":"https://my.qvard.com/pay/..."} // فتح نافذة الدفع في المتصفح <script src="https://qvard.com/checkout.js"></script> <script> // 1. وصف الدفع var checkout = new QvardCheckout({ mode: 'modal', paymentUrl: 'https://my.qvard.com/pay/...', // خذ redirectUrl من رد الخادم onSuccess: function (e) { // 3. معالجة النتيجة console.log('paid', e.paymentId); } }); // 2. إنشاء وعرض النافذة checkout.open(); </script>
<div id="checkout"></div> <script src="https://qvard.com/checkout.js"></script> <script> // 1. وصف الدفع var checkout = new QvardCheckout({ mode: 'inline', target: '#checkout', publishableKey: 'qvard_pk_YOUR_PUBLISHABLE_KEY', price: 10, onSuccess: function (e) { // 3. معالجة النتيجة console.log('paid', e.paymentId); } }); // 2. إنشاء وعرض النافذة checkout.open(); </script>
المرجع الكامل لواجهة API: api.qvard.com/doc
| الخيار | الوصف |
|---|---|
| mode | modal | inline |
| target | محدد CSS أو عنصر DOM (وضع inline فقط) |
| publishableKey | المفتاح العام الخاص بك—مطلوب لإنشاء دفعات من المتصفح |
| paymentId | معرف UUID للدفع الذي تم إنشاؤه مسبقاً—مطلوب لتدفق الخادم |
| paymentUrl | URL الدفع الكامل من استجابة الخادم—مطلوب لتدفق الخادم |
| price | المبلغ بالدولار الأمريكي (مطلوب مع publishableKey) |
| orderId | معرف المعاملة الخاص بك (اختياري، 128 حرف كحد أقصى، ينشأ تلقائياً إذا تم حذفه) |
| paymentSystemId | معرف طريقة الدفع (اختياري، من إعدادات حسابك) |
| locale | لغة صفحة الدفع: en, ru, es, pt, tr, id, vi, fr, de (الافتراضي هو لغة المتصفح) |
| theme | light | dark (اختياري) |
| onSuccess | دالة استدعاء عند نجاح الدفع: function(e) { console.log(e.paymentId); } |
| onClose | دالة استدعاء عند إغلاق النافذة بدون دفع |
| onError | دالة استدعاء عند حدوث خطأ: function(err) { console.log(err.code, err.message); } |
رموز الأخطاء: invalid_mode, invalid_target, invalid_options, invalid_payment_url, network_error, invalid_key, origin_not_allowed, duplicate_order, rate_limited, invalid_request, payment_failed.