الحالات والتأكيدات وإثباتات الدفع

دورة الحياة باختصار#

open ──(payment seen)──▶ pending ──(enough confirmations, full amount)──▶ paid / overpaid
  │                        │
  │                        └─(quote expired + 10 min grace, still short)──▶ underpaid
  ├─(nothing arrives before expiry)──▶ expired
  ├─(payment seen only after quote expiry + 10 min)──▶ late
  └─(merchant cancels, no payment yet)──▶ canceled

مرجع الحالات#

كل تغيير في الحالة يُنشئ حدث Webhook واحدًا (invoice.pending، invoice.paid، …). راجع إشعارات Webhook.

متى تُعدّ الفاتورة مدفوعة؟#

للعملة التي اختارها المشتري، يجمع RugWard المدفوعات المؤكدة التي رُصدت قبل انتهاء العرض مضافًا إليه 10 دقائق سماح (فالمعاملة المُذاعة قبيل الموعد النهائي تُحتسب). وتكون الفاتورة:

• paid عندما يبلغ المجموع على الأقل المبلغَ المسعَّر ناقص هامش تسامح صغير: الإزاحة الفريدة زائد 0.1% (لتغطية المحافظ التي تقرّب آخر الأرقام)؛
• overpaid عندما يزيد بأكثر من 1% على المبلغ المسعَّر.

لا تُجمع أبدًا مبالغ بعملات مختلفة. وعلى Base، حيث تُقسَّم الـ 0.5% على السلسلة، يُجرى الفحص على الـ 99.5% التي تصل إليك.

التأكيدات#

كيف يرصد RugWard المدفوعات#

الحمايات المدمجة في الرصد:

• معاملة واحدة تدفع فاتورة واحدة. لا يمكن احتساب المعاملة إلا مرة واحدة لكل شبكة وعنوان مستلم.
• لا سرقة للمعاملات (front-running). لا يُقبل معرّف معاملة لصقه شخص آخر إلا إذا طابق المبلغ الفريد الدقيق لهذا العرض أو حمل مرجع هذا العرض.
• لا معاملات قديمة. المعاملة المعدَّنة قبل إنشاء العرض لا تستطيع دفعه.
• تُرفض المعاملة الملصوقة بمبلغ مختلف برسالة "Contact the merchant with the transaction id"؛ ويسوّي التاجر الأمر يدويًا.
• يُحسب السعر على الخادم فقط؛ ولا يرسل متصفح المشتري أي سعر أبدًا.

المبالغ المستردة#

RugWard Pay غير احتجازي: المال موجود أصلًا في محفظتك أنت، لذا لا يستطيع RugWard ردّ أي شيء أو عكسه أو إجراء استرداد قسري. لإعادة المال إلى مشترٍ أرسل العملات بنفسك من محفظتك، ويُفضَّل إلى عنوان يعطيك إياه المشتري (لا تلقائيًا إلى العنوان المُرسِل، فقد يعود إلى منصة تداول). احتفظ بمعرّف الفاتورة وروابط المعاملات في سجلاتك.

إثباتات الدفع#

لكل فاتورة paid أو overpaid صفحة إثبات عامة قابلة للمشاركة على https://rugward.com/pay/proof/<invoice id> (وبصيغة JSON على /api/pay/proof/<invoice id>). تعرض المبلغ بالدولار، والتاجر، ووقت التأكيد، ومبلغ العملة المسعَّر والسعر مع مصادره، وعنوان الاستلام، وكل معاملة مؤكدة مع رابط المستكشف. يمكن لأي شخص إعادة فحص تلك المعاملات على البلوك تشين العامة.

لا تُفهرس محركات البحث صفحات الإثبات. ولا يوجد إثبات للفواتير غير المدفوعة (404).

انتهاء الصلاحية بالتفصيل#

• صلاحية الفاتورة (من 15 دقيقة إلى 7 أيام): بعدها لا يمكن تثبيت سعر جديد.
• صلاحية العرض (تثبيت السعر): 30 دقيقة بعد اختيار المشتري للعملة. إن بقي أقل من 5 دقائق، فإن اختيار العملة نفسها مجددًا يثبّت سعرًا جديدًا.
• السماح: المدفوعات المرصودة حتى 10 دقائق بعد انتهاء العرض تُحتسب بشكل طبيعي.
• لا تصبح الفاتورة expired إلا بعد انتهاء الفاتورة وآخر عرض لها (مع السماح) دون أي دفعة.