whollycrypto.
العربية

إضافة BTCPAY SERVER

عملات مستقرة في صفحة دفع BTCPay.

أضف Wholly Crypto لقبول USDC وUSDT وأصول أخرى يقبلها المتجر. احتفظ بطرق Bitcoin وLightning الموجودة في BTCPay.

احصل على الإضافة

v1.0.1

BTCPay Server 2.4.4+ وتثبيت Wholly Crypto منفصل. اختُبر مع BTCPay 2.4.4؛ اختبر الإصدارات الأحدث على بيئتك.

تنزيل الإضافة ↖GitHub والدليل الكامل ↖

بترخيص MIT · موصل مستقل، وليس اعتمادًا من BTCPay أو إدراجًا في دليله.

صفحة دفعك، بخيارات أكثر

  • صفحة دفع مستضافة أو iframe مضمّن اختياري
  • اختر من الشبكات والأصول المقبولة في متجر Wholly
  • IPN موقّعة مع فحوصات API موثّقة الهوية
  • مدفوعات مرتبطة قابلة للبحث وتشخيص الاتصال

تصل المدفوعات إلى محافظ مشروع Wholly. لا يحتاج الموصل إلى مفاتيح المحافظ. تنطبق قواعد رصيد معالجة Wholly؛ ولا تضيف الإضافة رسومًا نسبية.

التثبيت

  1. نزّل BTCPayServer.Plugins.WhollyCrypto.btcpay وتحقق منه مقابل ملف الإصدار SHA256SUMS. استخدم ملف الإضافة، لا ZIP الشيفرة المصدرية من GitHub.
  2. بصفتك مسؤول BTCPay، افتح إدارة الإضافات ← رفع إضافة، وارفع الملف وأعد تشغيل BTCPay.
  3. اختر متجرًا ← الإضافات ← Wholly Crypto. التثبيت وحده لا يربط متجرًا.

تستخدم التحديثات عملية الرفع نفسها. تحديث برنامج Wholly للتاجر لا يحدّث إضافة BTCPay.

اربط متجرًا

  1. في Wholly، أنشئ مشروعًا ومتجرًا مفعّلَين بطرق دفع مقبولة ومحافظ محفوظة احتياطيًا وأسعار وتأكيدات. استخدم تثبيت تاجر حديثًا؛ يستهدف هذا الموصل API الإصدار 6.4.5.
  2. انسخ UUID المشروع والمتجر من المتجر ← أساسي ← معرّفات API. أنشئ مفتاح API للقراءة والكتابة مقيدًا بالمشروع. فعّل المتجر ← IPN وانسخ سر التوقيع الخاص به، لا سر webhook.
  3. في إعدادات Wholly داخل BTCPay، أدخل هذه القيم مع أصلَي API وصفحة الدفع، مثل https://api.example.com و https://pay.example.com. استخدم HTTPS عامًا على المنفذ 443، دون مسارات.
  4. فعّل عرض Wholly Crypto عند الدفع، واحفظ، ثم اختبار صلاحية القراءة. يمكنك اختيار مجموعة فرعية من طرق الدفع المقبولة في المتجر.

اسمح بإشعارات HTTPS من خادم Wholly إلى BTCPay عبر جدارَي الحماية. توفر الإضافة رابط الإشعار. لا تضع دخول المتصفح أو CAPTCHA أو Basic Auth على هذا المسار؛ ويجب إبقاء التحقق من التوقيع مفعّلًا.

صفحة دفع مضمّنة

صفحة الدفع الكاملة هي الافتراضية، وتفيد خصوصًا مع تطبيقات المحافظ على الهاتف. لاستخدام iframe:

  1. في Wholly، ضمن المتجر ← متقدم، فعّل السماح بصفحة دفع مضمّنة. أضف أصل HTTPS المطابق تمامًا لـBTCPay إلى أصول HTTPS المسموح بها، دون مسار أو حرف بدل.
  2. في إعدادات إضافة BTCPay، اختر دفع العميل ← صفحة دفع مضمّنة (iframe) واحفظ.
  3. اختبر فاتورة جديدة. تحتفظ الفواتير الموجودة بوضع العرض الأصلي. افتح صفحة الدفع الكاملة يبقى متاحًا للفاتورة نفسها إذا لم يُحمّل الإطار.

رسائل المتصفح وروابط العودة للتنقل فقط، وليست إثباتًا للدفع.

اختبر مسار الدفع

أنشئ فاتورة نقدية موجبة صغيرة في متجر تجريبي. اختر عملات مستقرة ومشفّرة · Wholly. اختبر صفحة الدفع وIPN الموقّعة والتحقق عبر API حتى التأكيد. نفّذ الطلب فقط اعتمادًا على فاتورة BTCPay المسوّاة، مرة واحدة لكل طلب.

اختبار صلاحية القراءة لا يختبر إنشاء الفاتورة أو IPN. استخدم الاتصال و المدفوعات المرتبطة للأخطاء الآمنة ومراجع الطلبات وفحوصات الدفع.

الحدود ومشكلات التسليم

للفواتير النقدية الثابتة الموجبة فقط: حتى ثماني خانات عشرية، ومع مهلة متبقية بين 5 دقائق و24 ساعة عند البدء. لا يشمل الموصل الفواتير المسعّرة بالعملات المشفّرة أو شحن الرصيد أو تنفيذ الطلب عبر طرق مختلطة أو رد الأموال. تحتاج المدفوعات المتأخرة أو الملتبسة إلى مراجعة.

عند ظهور فشل التسليم، راجع Wholly: المتجر ← IPN ← السجل ← التفاصيل. افحص الوصول عبر الشبكة وسر التوقيع. لا تنشئ فاتورة أخرى للالتفاف على نتيجة غير مؤكدة.

قد يوقف انخفاض رصيد المعالجة IPN مع بقاء الدفع متاحًا للعملاء. حافظ على رصيد كافٍ ومزوّدين سليمين. قواعد الرصيد ← · دليل IPN ←