اقبل مدفوعات Lightning.

اتصال بمحفظة، لا عقدة عامة.

يمكن لنقطة Bitcoin عامة قراءة البلوكتشين. لكنها لا تستقبل مدفوعات Lightning نيابة عنك. يحتاج Lightning إلى محفظة تنشئ الفواتير وتبلغ عن تسويتها.

NWC بروتوكول اتصال، وليس ضمانًا لطريقة حيازة الأموال. اختر نموذج المحفظة المناسب لنشاطك. لا يحتفظ Wholly Crypto بأموال Lightning ولا يثبّت عقدة.

اربط عقدة LND.

1. افتح الإعدادات ← اتصالات الشبكات ← ربط Lightning. اختر LND · HTTPS.
2. أدخل نقطة HTTPS REST قابلة للوصول من الخارج وmacaroon مقيدًا بصيغة سداسية عشرية. اسمح بقراءة الفواتير وكتابتها وبـ info:read. أضف offchain:read إذا أردت عرض أرصدة القنوات. لا تستخدم أبدًا admin.macaroon ولا تمنح أذونات الإنفاق.
3. إذا استخدمت LND شهادة TLS خاصة بها، ألصق شهادتها العامة بصيغة PEM. لا تلصق مفتاح TLS الخاص. اسمح بالوصول من خادم التاجر في جدار حماية العقدة.
4. حدّد المشاريع المسموح لها باستخدام الاتصال. افحصه واحفظه ثم فعّله للفواتير الجديدة.

يجب أن تتزامن العقدة مع شبكة Bitcoin الرئيسية. يبقى التحقق من TLS مفعّلًا. يقبل هذا الاتصال عناوين HTTPS العامة فقط؛ وتُحظر العناوين الخاصة والمحلية والمحجوزة. أبقِ العقدة منفصلة عن خادم الدفع.

أذونات macaroon في LND ↖

اربط عبر Nostr Wallet Connect.

1. في Alby Hub أو محفظة متوافقة أخرى، أنشئ اتصالًا مخصّصًا للاستقبال.
2. اسمح بـ make_invoice, lookup_invoice و get_info. get_balance اختياري. لا تسمح بطرق الدفع أو السحب.
3. اختر Nostr Wallet Connect في Wholly Crypto وألصق سلسلة nostr+walletconnect://… الاتصال كاملة. تعامل معها ككلمة مرور.
4. استخدم relay عامًا واحدًا عبر WSS في سلسلة الاتصال. اختر نموذج حيازة الأموال وصلاحيات المشاريع، ثم افحص واحفظ.

يتحقق Wholly Crypto من الاستجابات الموقّعة ويدعم تشفير NIP-44 v2 مع توافق NIP-04 القديم. يجب أن تدعم المحفظة الاستعلام عن الفواتير الواردة مع إثبات التسوية. لا يدعم كل حساب NWC جميع طرق الاستقبال.

دليل Alby Hub ↖ · مواصفات NWC ↖

فعّله لمتجرك.

افتح المشروع ← المتاجر ← طرق الدفع ← Bitcoin Lightning. اختر الاتصال وفعّله. Bitcoin على الشبكة خيار منفصل؛ يمكنك تقديم أحدهما أو كليهما.

أنشئ فاتورة صغيرة يدويًا أو عبر API المعتادة. اختر Bitcoin ثم Bitcoin Lightning في صفحة الدفع. امسح QR أو افتح الطلب في محفظة Lightning. لا تحتاج إلى مسار API جديد لإنشاء فاتورة.

مدفوع يعني تمت تسويته.

يحصل كل طلب على فاتورة BOLT11 وبصمة دفع خاصتين به. تستخدم الأسعار عملة المتجر النقدية وهامشه، مع التقريب إلى أعلى إلى ساتوشي كامل. يسجّل Wholly Crypto الاستلام بدقة ملّي ساتوشي.

دفعة محجوزة أو مكتشفة لا تكفي. يجب أن تبلغ المحفظة عن التسوية بإثبات دفع صالح. لا تحتاج إلى تأكيدات كتل. يتبع سجل الفواتير ورسوم المعالجة وIPN وwebhooks مسار الفواتير المعتاد.

تستخدم LND اشتراك تسوية واحدًا لكل اتصال مع استعلامات استعادة. يستخدم NWC استعلامات الفواتير. تُفحص الطلبات المعلّقة عادة كل 10 ثوانٍ تقريبًا؛ وقد تؤخر الانقطاعات والطوابير وحدود المزوّد التحديثات. تستمر مراقبة الطلبات غير المسوّاة 24 ساعة بعد موعد فاتورة التاجر.

تعطيل بيانات الاتصال أو استبدالها لا ينقل طلبًا موجودًا إلى محفظة أخرى. أبقِ بيانات الاستقبال القديمة تعمل حتى تنتهي الطلبات المعلّقة. لا ينبغي دفع الطلبات المنتهية أو الملغاة.

هذا التكامل يستقبل المدفوعات. استخدم المحفظة المتصلة للإرسال أو رد الأموال أو إدارة القنوات أو التحويل إلى منصة تداول. أرصدة Lightning أرصدة محفظة مشتركة، وليست محافظ مشاريع منفصلة. رسوم المزوّد والتوجيه والقنوات منفصلة عن رسوم معالجة Wholly Crypto.

جهّز السعة والنسخ الاحتياطية.

تحتاج عقدتك إلى سعة واردة في القنوات للاستقبال. قد تفشل محفظة متصلة في استقبال دفعة إذا لم يوجد مسار صالح أو سعة استقبال. قد تساعد خدمة سيولة، لكن التكاليف والشروط تختلف.

النسخة النصية لمحافظ المشروع لا تنسخ Lightning احتياطيًا. اتبع إجراء الاستعادة الخاص بعقدتك أو محفظتك، بما فيه نسخ القنوات المطلوبة. قد لا تستعيد عبارة البذرة وحدها أموال القنوات بأمان. انسخ قاعدة Wholly Crypto ومفتاح تشفيرها احتياطيًا للحفاظ على تتبع الفواتير وبيانات الاتصال المشفّرة.

دليل استعادة LND ↖

افحص الاتصال أولًا.

• رُفض الوصول: تحقق من صلاحيات الاستقبال واستمرار صلاحية بيانات الاتصال.
• فشل الاتصال: افحص HTTPS/WSS وTLS وDNS والوصول عبر جدار الحماية واتصال المحفظة بالإنترنت.
• الطلب غير متاح: افحص صلاحيات المشروع وتفعيل المتجر وأسعار الصرف الحالية وحالة الشبكة الرئيسية للمحفظة.
• لا يوجد مسار للدفع: افحص السيولة الواردة في محفظة Lightning. اتصال API السليم لا يثبت وجود مسار.

اختبر دفعة صغيرة ومسار إشعاراتها قبل تقديم Lightning للعملاء. لا ترسل مفاتيح المحافظ أو macaroons أو أسرار NWC إلى الدعم أبدًا.