RugWard Pay
الفواتير وروابط الدفع والمدفوعات التجريبية
أنشئ الفواتير من اللوحة، وشارك روابط دفع وأزرارًا قابلة لإعادة الاستخدام، وجرّب عملية الدفع كاملةً مجانًا على شبكة تجريبية، وتعامل مع المدفوعات غير المطابقة.
في هذه الصفحة
إنشاء فاتورة#
في اللوحة املأ New invoice وانقر Create invoice. تحصل على رابط دفع ترسله إلى المشتري (https://rugward.com/pay/i/<id>).
| الحقل | القواعد | ملاحظات |
|---|---|---|
| ① Amount (USD) | من 1 إلى 50,000 دولار، بحدّ أقصى منزلتين عشريتين (25 أو 25.50) | يدفع المشتري ما يعادله بالعملة التي يختارها. |
| ② Expires after | في اللوحة: 30 دقيقة أو ساعة (الافتراضي) أو 3 ساعات أو يوم أو 7 أيام؛ وعبر API: من 15 دقيقة إلى 7 أيام | بعد انتهاء الصلاحية تعرض صفحة الدفع "Do not send anything" ولا يمكن تثبيت سعر جديد. |
| ③ Order id (اختياري) | حتى 64 محرفًا: أحرف وأرقام و. _ - : # / | مرجعك الخاص؛ يُعاد في API وفي إشعارات Webhook. |
| ④ Return URL (اختياري) | عنوان كامل يبدأ بـ https:// | لا يظهر للمشتري إلا بعد دفع الفاتورة، كزر "Return to <موقعك>". |
| Description (اختياري) | حتى 200 محرف | يظهر للمشتري، مثل "1 × قميص، مقاس M". |
يختار المشتري العملة في صفحة الدفع، ويُثبَّت السعر لمدة 30 دقيقة من تلك اللحظة (لا من لحظة إنشاء الفاتورة)، فطول صلاحية الفاتورة لا يعرّضك لتقلبات السعر.
لا تشحن إلا بعد أن تقول اللوحة (أو إشعار invoice.paid) إن الفاتورة Paid. وصول المشتري إلى رابط العودة ليس دليلًا على الدفع؛ فأي شخص يستطيع فتح رابط.
قائمة الفواتير وتفاصيلها#
يعرض قسم Invoices أحدث فواتيرك مع التاريخ والمبلغ ورقم الطلب والحالة. يفتح زر Details فاتورةً واحدة: عروض الأسعار (العملة والمبلغ والسعر والعنوان)، وكل دفعة شوهدت على السلسلة مع تأكيداتها ورابط المستكشف، والأزرار Open checkout وPayment proof (للفواتير المدفوعة) وCancel invoice.
تسميات الحالة التي ستراها:
| التسمية | حالة API |
|---|---|
| Awaiting payment (بانتظار الدفع) | open |
| Payment detected, confirming (تم رصد الدفعة، جارٍ التأكيد) | pending |
| Paid (مدفوعة) | paid |
| Paid (more than requested) (مدفوعة بأكثر من المطلوب) | overpaid |
| Underpaid (مدفوعة بأقل من المطلوب) | underpaid |
| Paid after expiry (مدفوعة بعد انتهاء الصلاحية) | late |
| Expired (منتهية) | expired |
| Canceled (ملغاة) | canceled |
معنى كل حالة وما يجب فعله: الحالات والتأكيدات والإثباتات.
إلغاء فاتورة#
يمكنك إلغاء فاتورتك ما دامت open ولم تُرصد أي دفعة. تُخبر صفحة الدفع المشتري حينها: "The merchant canceled this invoice. Do not send anything to it." ويُرسَل إشعار invoice.canceled. لا يمكن إلغاء فاتورة لها دفعة في الطريق (الرمز 409).
روابط الدفع والأزرار#
رابط الدفع رابط قابل لإعادة الاستخدام بسعر ثابت: منتج، أو تبرع، أو اشتراك شهري. كل مشترٍ ينقر Pay with crypto يحصل على فاتورته الجديدة الخاصة (صالحة 60 دقيقة)، فلا تختلط المدفوعات أبدًا.
- أدخل المبلغ بالدولار والوصف ورابط عودة اختياريًا، ثم Create link.
- تعرض اللوحة عرض المشتري (ما يراه المشترون تمامًا)، والرابط
https://rugward.com/pay/l/<id>، وعدد مرات استخدامه. - Copy link لمشاركته في محادثة أو بريد أو على وسائل التواصل، أو Copy button HTML لوضع زر "Pay with crypto" على موقعك.
- Turn off يوقف الرابط، ولا تتأثر الفواتير التي أُنشئت منه سابقًا.
الزر رابط HTML عادي؛ لا يحمّل أي سكربت ولا يضع أي ملف تعريف ارتباط:
<a href="https://rugward.com/pay/l/k33JZ0ij5F2yLDprwrQgjN" target="_blank" rel="noopener"
style="display:inline-block;padding:10px 20px;border-radius:12px;background:#f0b90b;color:#000;font:600 15px system-ui,sans-serif;text-decoration:none">Pay with crypto</a>
معلومات مفيدة:
- تحمل الفواتير المُنشأة من رابط رقم الطلب
link:<أول 8 محارف من معرّف الرابط>، لتميّزها في القائمة وفي API وإشعارات Webhook. - الحدود: 100 رابط نشط لكل تاجر؛ ويُنشئ الرابط الواحد 100 فاتورة في الساعة كحد أقصى (لحماية حصتك الساعية من الإساءة). فتح الرابط محمي بـ Cloudflare Turnstile عند الحاجة.
الفواتير التجريبية (مجانية، شبكة Sepolia)#
افتح Test invoice (Sepolia testnet) في اللوحة لتجربة عملية الدفع كاملةً دون أموال حقيقية. يدفع المشتري بـ Sepolia test ETH أو USDC التجريبي من Circle على Sepolia عبر عقد تقسيم RugWard Pay المنشور على Sepolia، والذي يرسل 99.5% إلى عنوان الاستلام و0.5% إلى محفظة رسوم RugWard، تمامًا كما على Base.
- المبلغ: من 1 إلى 100 دولار. عنوان استلام تجريبي اختياري (عنوان EVM)، وإلا يُستخدم عنوان EVM الخاص بك.
- العملات التجريبية بلا قيمة ومجانية: Sepolia ETH من صنبور (مثل صنبور Google Cloud لـ Sepolia) وUSDC التجريبي من صنبور Circle (اختر Ethereum Sepolia).
- تحمل الفواتير التجريبية علامة TEST في صفحة الدفع والقائمة والإثبات؛ ولا تستدعي أبدًا إشعار Webhook ولا يمكن إنشاؤها بمفتاح API، فلا يمكن لاختبار أن يتسبب في شحن طلب حقيقي.
المدفوعات غير المطابقة#
قد يصل تحويل إلى عنوانك دون أن يطابق فاتورة بدقة: مبلغ خاطئ، أو دفعة أُرسلت بعد انتهاء الصلاحية بوقت طويل، أو تحويل لا علاقة له. لا يضع RugWard عليها أبدًا حالة مدفوعة تلقائيًا. إن وُجدت، تعرض اللوحة مربع Unmatched payments بالمبلغ والشبكة ورابط المعاملة والفاتورة التي كانت قيد الفحص عند رصده.
ما يجب فعله: افتح المعاملة، وتواصل مع المشتري، وسوِّ الأمر بنفسك (سلّم الطلب، أو أعد المال من محفظتك). ثم انقر Dismiss.
آخر تحديث: 30 أكتوبر 2026