حدّد حدود المحفظة
محفظة للمراقبة فقط تقدر تكتشف المدفوعات من غير ما تحتفظ بمفاتيح الإنفاق الخاصة. المفتاح العام الممتد لسه بيكشف نشاط محفظة حساس ولازم يتحمي. تكامل Lightning ممكن يحتاج محفظة أونلاين وبيضيف مخاطر تشغيلية إضافية.
اختار الحجم للحزمة الكاملة
خلفية Bitcoin وقاعدة بيانات وخدمة ويب وعقدة Lightning اختيارية ليهم احتياجات تخزين وذاكرة مختلفة. راجع تعليمات النشر المدعومة الحالية ومتطلبات النمو قبل ما تختار جهاز صغير.
أمّن واجهة التاجر
استخدم اسم مضيف مخصصًا وHTTPS وحماية تسجيل دخول قوية ووصولًا إداريًا مقيّدًا. أبقِ الخادم محدثًا وتحقق من توقيعات webhook أو آليات التحقق المدعومة في التطبيق المستقبِل. لا تشحن البضائع بناءً على إعادة توجيه المتصفح فقط.
اعمل نسخة احتياطية وطابق البيانات
احمِ إعداد المتجر وقاعدة البيانات ومعلومات استرداد المحفظة والمواد الخاصة بـ Lightning وفقًا للوثائق ذات الصلة. اختبر الاسترداد وطابق الفواتير مع نظام الدفع، خاصةً فيما يتعلق بالانتهاء والدفع الناقص والمبالغ المستردة.
تحقق من النشر واستراتيجية السلسلة
استخدم تعليمات النشر المدعومة الحالية واسم مضيف مخصص ومسار HTTPS متحقق منه. السلسلة المقصوصة ممكن تقلل متطلبات التخزين المستمرة لو مدعومة، لكن لازم تفهم احتياجات إعادة الفحص والاستعادة. ما تختارش القرص بناءً على حجم السلسلة الحالي لوحده؛ سيب مساحة للمكدس الكامل والنمو.
- تحقق من رد نداء الدفع من اختبار خارجي
- استخدم مدفوعات تجريبية قبل متجر مباشر
- أكد سياسة تسوية الفاتورة
الوثائق الرسمية: خيارات نشر BTCPay
خلّي مفتاح الإنفاق في المكان اللي انت قاصده
إعداد المراقبة فقط يقدر يكتشف المدفوعات من مفتاح عام ممتد من غير ما يدّي السيرفر مفتاح الإنفاق. الـ xpub حساس لأنه بيكشف نشاط المحفظة. المحفظة الساخنة بتغيّر الخطر ده بوضع قدرة الإنفاق أونلاين. راجع حفظ المحفظة وLightning كل واحد لوحده واتبع عملية النسخ الاحتياطي المدعومة.
الوثائق الرسمية: نموذج محفظة BTCPay
جهّز قائمة تحقق للنشر حول الحزمة المختارة
ابدأ بنطاق مخصص وطريقة نشر مدعومة ووضع سلسلة مقصود ومساحة قرص كافية للمزامنة. راجع مولّد Docker الأصلي ومكوناته المختارة قبل التثبيت؛ احتفظ بخيارات النشر غير السرية حتى يمكن إعادة بناء جهاز آخر بشكل متسق. تحقق من تحليل النطاق وإصدار الشهادة وملكية الحساب الإداري قبل عرض الدفع للعملاء. مثال Docker Compose عام ليس دليلاً على أن كل مكوّن اختياري في BTCPay مُعدّ.
- حدد مين مالك النسخة اللي بيتحكم في التحديثات والمراقبة والنسخ الاحتياطية والاستجابة للحوادث.
- افصل تعريض الوكيل العكسي عن Bitcoin RPC الخاص وقاعدة البيانات وإدارة Lightning.
- وثّق حدود الاستعادة/إعادة الفحص للخلفية المقصوصة قبل ما توصل محفظة بمدفوعات قديمة.
- احتفظ ببيئة اختبار مدعومة أو تجربة دفع صغيرة مُتحكَّم بها للتكاملات قبل تنفيذ طلبات ذات قيمة.
الوثائق الرسمية: BTCPay Server: خيارات النشر · BTCPay Server: نشر Docker مدعوم
تحقّق من مدفوعات المحفظة المفقودة دون استيراد بذرة
يمكن لمتجر استخدام معلومات xpub/الاشتقاق الخاصة بمحفظة بينما يبقى مفتاح الإنفاق على جهاز آخر. اختبر الاستلام ومسار الاستعادة مع المحفظة المختارة. إذا رأى BTCPay دفع فاتورة لكن محفظة خارجية لا تُظهره، فافحص مخطط الاشتقاق وسلوك حد الفجوة في العناوين قبل افتراض اختفاء الأموال. قد تؤثر السلاسل الطويلة من العناوين المولّدة غير المدفوعة على اكتشاف المحفظة. استخدم تشخيصات المحفظة المدعومة بدلًا من نسخ كلمات الاستعادة إلى الخادم.
الوثائق الرسمية: BTCPay Server: استكشاف أخطاء المحفظة والاشتقاق
طابق الفواتير قبل التنفيذ
سجّل معرّفات الفواتير وخلّي عملية التنفيذ idempotent. رجوع المتصفح للمتجر حدث تنقّل، مش دليل على التسوية. تحقق من حالة الدفع من خلال تكامل السيرفر الموثّق بتاعك، وتعامل مع الفواتير المنتهية أو المتأخرة أو الناقصة الدفع بشكل صريح، واحتفظ بمسار مراجعة للنتائج غير المحلولة. لو الـ callback اتكرر، إرجاع إقرار ناجح مينفعش يشحن أو يضيف رصيد للطلب مرتين.
- اختبر دفعة تصل قرب انتهاء الصلاحية وتحقق من بقاء الطلب مرتبطًا بالفاتورة الصحيحة.
- احتفظ بقاعدة البيانات وإعدادات المتجر ومواد استرجاع المحفظة في نسخة احتياطية مستقلة متجرَّبة.
- يضيف Lightning مسؤولية منفصلة عن السيولة والنسخ الاحتياطي للقنوات؛ استعادة كامل VPS الخاص بالأمس ليس إجراء استرداد آمنًا عالميًا.
- استضافة نسخة BTCPay مش بتضيف Lightning أو XMR لدفع عملاء KoalaVPS؛ طرق الدفع في موقع الاستضافة ده تفضل مساراته السبعة المنشورة.
الوثائق الرسمية: دليل مطوّري Bitcoin: التحقق من الدفع · LND: استعادة بعد الكوارث · Core Lightning: نسخ احتياطية للمحفظة والقنوات