اكتشاف المعاملة وتأكيد السلسلة وربط الطلب وتسليم الخدمة خطوات منفصلة. تحقق من السلسلة والأصل والمستلم والمبلغ الصحيحين؛ وطبّق سياسة قبول موثقة؛ واجعل التسوية خاملة التكرار. لا يمكن لمرجع معاملة أو لقطة شاشة أو زر في المتصفح وحده أن يثبت أن طلباً معيناً قد دُفع.
افصل حدث السلسلة عن حدث الطلب
إبلاغ المحفظة بأن تحويلاً قد أُرسل هو دليل على إجراءاتها الخاصة، وليس قرار دفع كاملاً. يجب على الواجهة الخلفية المستقبِلة أن تراقب الشبكة المقصودة، وتتحقق من التحويل الفعلي، وتربطه بطلب. عندئذٍ فقط يمكن للطلب تطبيق سياسة القبول الخاصة به. تسليم البنية التحتية خطوة تشغيلية أخرى بعد قبول الدفع.
أبقِ هذه الانتقالات صريحة في الكود ولغة العميل على حد سواء. يمكن لشاشة أن تعرض "في الانتظار" أو "مكتشفة" أو "قيد التأكيد" دون اعتبار الطلب مدفوعاً. لا تدع المتصفح يزوّد المبلغ المقبول أو يكتب فوق حالة موثوقة. خزّن عرض السعر الذي أنشأه الخادم وتعليماته حتى يمكن تقييم التسوية اللاحقة مقابل الطلب الأصلي بدلاً من سلة متغيرة.
استخدم قواعد ثقة خاصة بكل سلسلة
تصف الشبكات المختلفة ثقة المعاملة بطرق مختلفة. يشرح دليل المطورين لـ Bitcoin كيف تختار العقد السلسلة ذات أكبر قدر متراكم من إثبات العمل وكيف يمكن أن تحدث كتل متنافسة. لذلك تحتاج معاملة شوهدت حديثاً إلى سياسة لعمق التأكيد والتغيرات المحتملة في السلسلة. لا يوجد عدد تأكيدات واحد مناسب لكل أصل ومخاطر تجارية.
تشرح وثائق إثبات الحصة لـ Ethereum نهائية نقاط التحقق، بينما توثّق Solana حالات الالتزام المعالجة والمؤكدة والنهائية. لا تترجم هذه المصطلحات بشكل عابر إلى عدد كتل عالمي واحد. سجّل القاعدة الخاصة بالشبكة ومصدر المعلومات والسلوك أثناء عدم اليقين. يجب على المشغّل تحديد عتبات القبول مقابل مخاطر الدفع والتسليم، لا نسخ رقم من عملية دفع غير ذات صلة.
تحقق من حمولة التحويل الفعلية
حدّد المستلم والأصل والمبلغ على السلسلة الصحيحة. تحتاج مدفوعات الرموز إلى هوية الرمز المقصودة، وليس مجرد معاملة ناجحة إلى عنوان. تحقق من نجاح التنفيذ ذي الصلة وأدلة التحويل وفقاً لنموذج السلسلة. حلّل المبالغ الصحيحة بالدقة المناسبة للأصل بدلاً من الوثوق بعلامة عشرية منسّقة يزوّدها المتصفح.
يجب أن تبقى تعليمة الدفع مرتبطة بمسارها الأصلي. لا ينبغي أن يفي بها تحويل على شبكة أخرى، أو رمز مختلف يحمل الرمز نفسه، أو مرجع معاملة غير ذي صلة. يجب أن يوضح سجل التحقق ما تم فحصه ويحفظ الأدلة اللازمة لمراجعة القرار. يصف هذا الدليل مبادئ تسوية الدفع العامة وليس تنفيذ خدمة معينة.
اجعل ربط الطلب بلا لبس
يمكن لعناوين الاستقبال الثابتة أن تستقبل عدة طلبات بمبالغ متشابهة. وجود تحويل مطابق لا يثبت أي عميل أو طلب يجب أن يُنسب إليه الرصيد. حدّد طريقة الربط قبل قبول المدفوعات الحية وضمّن معالجة التعارضات. لا يزال مرجع المعاملة الذي يقدمه المستخدم يتطلب التحقق من أن التحويل نفسه لم يُسند في مكان آخر بالفعل.
تخيل فاتورتين بالمبلغ نفسه على المسار نفسه خلال نافذة زمنية متداخلة. يرى المراقب تحويلاً واحداً. تعليم كليهما مدفوعين تلقائياً خطأ؛ واختيار أحدهما دون أدلة كافية غير آمن أيضاً. أبقِ التحويل غير مخصص أو قيد المراجعة حتى تتمكن سياسة المشغّل من إثبات ربط صحيح. المطابقة الغامضة حالة يجب معالجتها، وليست سبباً لاختلاق اليقين.
حدد حالات تتحمل الأدلة المتأخرة والمتغيرة
تستفيد عملية الدفع من مجموعة صغيرة من الحالات الواضحة، مع فصل أدلة السلسلة عن قرار قبول الطلب. يشرح هذا الجدول التوضيحي المراحل المحتملة بدلاً من وصف أسماء حالات خدمة معينة. يجب أن يكون لكل انتقال سبب موثّق، ويجب أن يبقى قبول الدفع متميزاً عن تسليم البنية التحتية.
ضمّن التحويلات المتأخرة والجزئية والزائدة وانتهاء صلاحية عرض السعر وبيانات السلسلة غير المتاحة مؤقتاً. انتهاء الصلاحية لا يجعل تحويلاً حقيقياً يختفي. قد يتطلب الدفع المتأخر مراجعة بدلاً من القبول أو الرفض التلقائي. إذا تغيّر حدث سلسلة شوهد سابقاً، أعد تقييم الحالة وفق السياسة الموثقة بدلاً من معاملة كل إشعار مراقب كحقيقة غير قابلة للنقض.
| حالة توضيحية | المعنى | القرار التالي |
|---|---|---|
| في الانتظار | لا يوجد تحويل مؤهل موثّق | واصل مراقبة الفاتورة الصالحة |
| مكتشفة | شوهد تحويل ذو صلة | تحقق من ثقة السلسلة والربط |
| قيد التأكيد | قاعدة القبول لم تتحقق بعد | راقب حتى تسمح السياسة بقرار |
| مراجعة | أدلة متأخرة أو جزئية أو غامضة | حلّها وفق سياسة المشغّل |
| مقبولة | دفع موثّق ومسوّى | انتقل إلى سير عمل تسليم منفصل |
اجعل إعادة المحاولات آمنة وقابلة للملاحظة
ستعيد المراقبات ومهام التسوية المحاولة بعد انقطاع الاتصالات أو إعادة تشغيل العمليات. استخدم هوية تحويل مستقرة، مثل السلسلة ومعرّف المعاملة أو التحويل المناسب، لمنع إضافة أرصدة مكررة. احفظ التقدم والقرارات بشكل دائم حتى يمكن معالجة الحدث نفسه مرة أخرى دون توفير خدمة ثانية أو تغيير عرض سعر مقبول.
ميّز بين نتيجة غير معروفة وعملية فاشلة. إذا انتهت مهلة طلب لاحق، افحص نتيجته الموثوقة قبل إعادة الإرسال. احفظ سجلات دائمة للإجراءات المقبولة وغير المؤكدة. قيّد الوصول إلى رموز الطلب والأدلة الداخلية مع الاحتفاظ بمعلومات كافية للتحقيق في دفع متنازع عليه. الموثوقية هنا تتعلق بقرارات قابلة للتكرار، لا برسوم متحركة سلسة في صفحة الدفع.
اعرف ما لا يزال الطلب المعلق يحتاجه
قد يبقى الطلب معلقاً لأن التحويل لم يُشاهد، أو لم يتم الوصول إلى ثقة السلسلة المطلوبة، أو يحتاج ربطه بالفاتورة إلى مراجعة. احفظ الفاتورة ومرجع المعاملة العام، وافحص قواعد القبول المذكورة، واستخدم عملية المساعدة المخصصة للطلب. تأخر تحديث الحالة ليس، بحد ذاته، سبباً لإرسال دفعة أخرى.
اتبع التعليمات والحالة الموثّقة للطلب الفعلي. يجب أن يحدد تأكيد الدفع قبول التحويل المسوّى، بينما يكون لتسليم الخدمة حالة منفصلة. أبقِ رموز الوصول الخاصة وأسرار المحفظة خارج طلبات المساعدة.
قائمة التحقق العملية.
- احفظ عرض سعر غير قابل للتغيير أنشأه الخادم.
- تحقق من السلسلة والمستلم والأصل والمبلغ الصحيح كعدد صحيح.
- وثّق قواعد القبول الخاصة بكل سلسلة.
- تعامل مع تعارضات العنوان الثابت دون تخمين.
- امنع إضافة الأرصدة المكررة وإعادة إرسال المحاولات غير الآمنة.
- اختبر حالات التأخر والجزئية والمسار الخاطئ وتغيّر الأدلة.
التفاصيل المهمة.
هل يكفي تجزئة المعاملة لتأكيد الدفع؟+
لا. تحقق من التحويل على السلسلة المقصودة، ومن حمولته وثقته، ثم أثبت أنه يخص الطلب ولم يُضف رصيده بالفعل.
هل يمكن لكل شبكة استخدام عتبة التأكيد نفسها؟+
لا. تعرض الشبكات نماذج مختلفة للثقة والنهائية. يجب على المشغّل تحديد واختبار سياسة قبول مناسبة لكل مسار.
هل يعني الدفع المؤكد أن الخادم قد تم توفيره؟+
لا. قبول الدفع والتسليم حدثان منفصلان في سير العمل. أبلغ عن حالة التوفير من عمليتها الموثوقة الخاصة.
اذهب إلى المصدر.
تدعم هذه المراجع المفاهيم التقنية في هذا الدليل. اتبع الوثائق الحالية قبل تغيير نظام إنتاجي.
- دليل مطوري Bitcoin: سلوك البلوكتشين developer.bitcoin.org
- Ethereum: إثبات الحصة والنهائية ethereum.org
- Solana: التزام حالة RPC solana.com
إرشاد تحريري من SwissOctet. الأمثلة توضيحية. يجب التحقق من مواصفات الخدمة والخيارات المتاحة والشروط التعاقدية بشكل منفصل.