إضافة الدفع بالعملات الرقمية لـ WooCommerce: اقبل USDC وUSDT

لكي تقبل العملات الرقمية في WooCommerce، تثبّت إضافة دفع ترسل المشتري إلى صفحة دفع بالعملات الرقمية وتضع الطلب كمدفوع عند تأكيد الدفعة. تفضّل معظم المتاجر العملات المستقرة مثل USDC وUSDT حتى لا يتغير السعر بين إتمام الطلب والدفع.

يقارن هذا الدليل إضافات الدفع بالعملات الرقمية لـ WooCommerce الشائعة، ثم يعدّ إضافة OrcaRail خطوة بخطوة، بدءًا من وضع الاختبار دون أموال حقيقية.

إفصاح: تنشر OrcaRail هذه المدونة وتطوّر إحدى الإضافات أدناه. معلومات الإضافات الأخرى مأخوذة من صفحاتها على WordPress.org وتم التحقق منها في 1 نوفمبر 2026. الإضافات تتغير، فراجع الصفحة قبل التثبيت.

ما الذي تبحث عنه في إضافة عملات رقمية لـ WooCommerce

• العملات المستقرة والشبكات. تأكد أن الإضافة تقبل الرموز التي يملكها عملاؤك، على شبكات منخفضة التكلفة مثل Base أو Polygon أو سولانا.
• webhooks موثّقة. يجب ألا يصبح الطلب مدفوعًا إلا بعد إشعار موقّع من خادم إلى خادم، لا بمجرد إعادة توجيه المتصفح.
• Checkout Blocks وHPOS. تستخدم متاجر WooCommerce الجديدة صفحة الدفع بالكتل وتخزين الطلبات عالي الأداء (HPOS). بعض الإضافات القديمة لا تدعمهما.
• وضع الاختبار. يجب أن تتمكن من إنشاء طلب تجريبي على شبكة اختبار قبل التشغيل الفعلي.
• الرسوم والحفظ. اعرف رسوم كل دفعة، وهل تصل الأموال إلى محفظتك أم إلى حساب لدى المزوّد.

مقارنة إضافات العملات الرقمية الشائعة لـ WooCommerce

الإضافة	رسوم المزوّد (كما هي مذكورة)	الحفظ	Checkout Blocks	التثبيتات النشطة
OrcaRail for WooCommerce	0.5% للنسخة المستضافة، وأول 100 معاملة مجانية	غير حاضن افتراضيًا: عناوين السحب الخاصة بك	نعم	جديدة (إصدار GitHub)
BTCPay for WooCommerce	"Zero fees" (تشغّل BTCPay Server بنفسك)	"Self-custodial"	إصلاحات في سجل التغييرات	أكثر من 1,000
CoinGate for WooCommerce	"Starting at 1%"	تصل الأموال إلى حسابك في CoinGate	نعم (v2.3.0)	أكثر من 400
NOWPayments for WooCommerce	غير مذكورة	غير مذكور	نعم	أكثر من 3,000

ملاحظات من الصفحات:

• BTCPay يركز على بيتكوين ويحتاج إلى BTCPay Server تستضيفه أو تستأجره.
• تحذّر صفحة CoinGate من أن الإضافة لم تُختبر مع آخر 3 إصدارات رئيسية من WordPress.
• تطوّر CoderPress إضافة NOWPayments for WooCommerce، وتوفّر اشتراكات العملات الرقمية في نسخة Pro فقط.

كيف تعمل إضافة OrcaRail

إضافة OrcaRail لـ WooCommerce مفتوحة المصدر (MIT) وتستخدم صفحة الدفع المستضافة من OrcaRail.

1. عند إتمام الطلب، تنشئ الإضافة payment intent وتؤكده عبر PHP SDK.
2. ينتقل المشتري إلى صفحة الدفع في OrcaRail ويدفع بالعملات الرقمية.
3. عند عودة المشتري، تتحقق الإضافة من الدفعة عبر الـ API. لا تثق أبدًا بإعادة التوجيه وحدها.
4. تستدعي الإضافة complete على الـ intent المدفوع. وتقوم مهمة WP-Cron كل ساعة بالشيء نفسه للطلبات الحديثة التي لم يعد مشتروها.
5. يحدّث webhook موقّع طلب WooCommerce. التحديثات idempotent، فلا تؤدي إعادة المحاولة إلى معالجة الطلب مرتين.

مدعوم: المنتجات بالدفع لمرة واحدة، وصفحة الدفع الكلاسيكية وCheckout Blocks، وHPOS، والـ webhooks الموثّقة، ووضع الاختبار. غير مدعوم بعد: الاسترداد من داخل WooCommerce، وWooCommerce Subscriptions وطرق الدفع المحفوظة، والمحافظ السريعة. تختار رمزًا وشبكة واحدة للاستلام؛ وللفوترة المتكررة استخدم API الاشتراكات في OrcaRail.

إعداد إضافة OrcaRail لـ WooCommerce

المتطلبات: PHP 8.1+ وWordPress 6.4+ وWooCommerce 8.0+ وحساب OrcaRail.

1. نزّل الإضافة. احصل على أحدث ملف ZIP من GitHub releases. يتضمن الاعتماديات، فلا تحتاج إلى Composer.
2. ثبّتها وفعّلها. في WordPress، انتقل إلى الإضافات ← أضف جديد ← رفع إضافة، وارفع ملف ZIP وفعّله.
3. أنشئ مفتاحًا تجريبيًا. في لوحة تحكم OrcaRail، افتح Go to sandbox وأنشئ مفتاح API (ak_test_…). تعمل البيئات التجريبية على شبكات الاختبار دون أموال حقيقية. راجع إنشاء بيئة تجريبية.
4. اختر الرمز والشبكة التي تستلم عليها. مثلًا USDC على شبكة اختبار الآن، وUSDC على Base عند التشغيل الفعلي. معرّفات الرمز والشبكة تأتي من GET /payments/networks وGET /payments/networks/:id/tokens. راجع الشبكات والرموز.
5. املأ الإعدادات. افتح WooCommerce ← الإعدادات ← المدفوعات ← OrcaRail، واملأ حقول Test (المفتاح، السر، سر توقيع الـ webhook، معرّف الرمز، معرّف الشبكة) وفعّل وضع الاختبار.
6. اضبط رابط الـ webhook. في لوحة تحكم OrcaRail، اجعل رابط webhook لمفتاح الـ API هو الرابط الذي تعرضه الإضافة: https://your-store.example/?wc-api=wc_gateway_orcarail&orcarail=webhook. راجع توقيعات الـ webhooks.
7. أنشئ طلبًا تجريبيًا. في صفحة الدفع على شبكة الاختبار يمكنك محاكاة الدفعة دون محفظة. تأكد أن الطلب أصبح مدفوعًا.
8. التشغيل الفعلي. أنشئ مفتاح API فعليًا (ak_live_…) في منظمتك الفعلية، واملأ الحقول الفعلية برمز وشبكة رئيسية، وأوقف وضع الاختبار. راجع الانتقال إلى التشغيل الفعلي.

يتجاهل المتجر الفعلي أحداث webhook التجريبية، ويتجاهل المتجر في وضع الاختبار الأحداث الفعلية، فلا يمكن الخلط بينهما بالخطأ.

التكلفة

تفرض نسخة OrcaRail المستضافة 0.5% من كل معاملة مكتملة، وأول 100 معاملة مجانية. طلب بقيمة 100 USD يكلف 0.50 USD. الإضافة نفسها مجانية. رسوم الشبكة منفصلة. راجع الأسعار والرسوم والحدود.

الأسئلة الشائعة

ما أفضل إضافة عملات رقمية لـ WooCommerce؟

يعتمد على ما تريد استلامه. لبيتكوين مع استضافة ذاتية، BTCPay ناضج. وللعملات المستقرة مثل USDC وUSDT على سلاسل EVM وسولانا، تُدفع إلى محفظتك مباشرة، صُمّم OrcaRail لذلك. قارن الرسوم والحفظ ودعم Checkout Blocks في الجدول أعلاه.

هل يمكنني قبول USDT في WooCommerce؟

نعم. اضبط رمز الإضافة وشبكتها على USDT على شبكة مدعومة مثل Ethereum أو Polygon أو Arbitrum. شبكة Tron (TRC20) غير مدعومة بعد. راجع كيف تقبل مدفوعات USDT.

متى يصبح طلب WooCommerce مدفوعًا؟

بعد تأكيد الدفعة على السلسلة وتحقق الإضافة منها عبر API ‏OrcaRail، من خلال الـ webhook أو التحقق عند العودة. إعادة توجيه المتصفح وحدها لا تجعل الطلب مدفوعًا أبدًا.

هل تدعم الإضافة WooCommerce Subscriptions؟

ليس بعد. تتعامل الإضافة مع المدفوعات لمرة واحدة. للفوترة المتكررة استخدم اشتراكات OrcaRail مباشرة أو اقرأ المدفوعات المتكررة بالعملات الرقمية.

هل يمكنني الاختبار دون عملات رقمية حقيقية؟

نعم. فعّل وضع الاختبار بمفاتيح البيئة التجريبية. تعمل الطلبات على شبكات الاختبار، ويمكنك محاكاة الدفعة في صفحة الدفع.

---

احصل على الإضافة · ابدأ في البيئة التجريبية · الأسعار