مدفوعات العملات المشفرة لـ WooCommerce
اقبل العملات المشفرة في WooCommerce. يختار العميل Crypto عند إتمام الطلب، ويدفع على صفحة SnapEX Pay بـ USDT على شبكات TRON وEthereum وBSC وغيرها، أو بعملات أخرى تُحوَّل إلى USDT، فتنتقل حالة الطلب إلى Processing تلقائيًا.
مجانًا. الإصدار 1.1.0.
ماذا تفعل الوحدة
- لا محافظ ولا عُقد تحتاج إلى تشغيلها: تصل الأموال إلى رصيد التاجر الخاص بك في SnapEX Pay.
- تعمل مع كتلة Checkout ومع صفحة
[woocommerce_checkout]الكلاسيكية، ومع روابط «Pay for order». متوافقة مع HPOS (جداول الطلبات المخصصة) ومع التخزين القديم للطلبات. - ثلاث طرق مستقلة لتعليم الطلب مدفوعًا: إشعار Webhook الموقّع، وعودة العميل من صفحة الدفع، وفحص في الخلفية (يشغّله WP-Cron كل 5 دقائق؛ ويُعاد فحص كل طلب معلّق مرة كل 10 دقائق على الأكثر، لمدة 5 أيام). ضياع إشعار Webhook لا يترك طلبًا مدفوعًا دون تسجيل أبدًا، ولا يُستكمَل أي طلب مرتين.
- يُقرأ المبلغ دائمًا من جديد عبر API الخاص بـ SnapEX Pay؛ ومحتوى إشعار Webhook وحده لا يُعلِّم أي شيء مدفوعًا أبدًا.
- الدفعات الجزئية والدفعات التي تصل بعد إلغاء الطلب تنقل الطلب إلى On hold لمراجعته.
- وضع الاختبار: تُؤكَّد الفواتير التجريبية من تلقاء نفسها دون أموال حقيقية؛ وما دام مفعّلًا لا يرى طريقة الدفع إلا مديرو المتجر.
التثبيت
- في لوحة إدارة WordPress افتح Plugins → Add New → Upload Plugin، وارفع
snapex-pay-for-woocommerce-1.1.0.zip، ثم اضغط Activate. (أو فك ضغط الأرشيف فيwp-content/plugins/.) - افتح WooCommerce → Settings → Payments → SnapEX Pay (crypto).
- في لوحة تحكم التاجر في SnapEX Pay أنشئ مفتاح API بالصلاحيتين
invoices.readوinvoices.write، والصقه في حقل API key. - Webhook (يُنصح به): في لوحة التحكم اضبط عنوان Webhook على
https://<your shop>/wc-api/snapexpay_webhook/(العنوان الدقيق يظهر تحت الحقل)، والصق السرwhsec_…في حقل Webhook secret. - إذا كانت عملة المتجر غير USD: املأ حقل «USD for 1 <currency>»، أو استخدم إضافة عملات عبر المرشِّح
snapexpay_wc_amount_usd. ومن دون أي منهما تُخفى طريقة الدفع عند إتمام الطلب. - فعّل Test mode، وضع طلبًا بصفتك مشرفًا، وادفعه على صفحة SnapEX Pay بطريقة تجريبية، وتحقّق من أن حالته أصبحت Processing. ثم أوقف وضع الاختبار.
الإعدادات
| Title, Description | ما يراه العميل عند إتمام الطلب. |
|---|---|
| API key | من لوحة تحكم SnapEX Pay. |
| Webhook secret | whsec_… من إعدادات Webhook في لوحة التحكم. من دونه تُعلَّم الطلبات مدفوعة مع ذلك عند عودة العميل وعبر الفحص في الخلفية. |
| Network fee paid by | Merchant: يدفع العميل إجمالي الطلب بالضبط، وتُخصم الرسوم مما تستلمه. Customer: تُضاف عمولة SnapEX Pay ورسوم الشبكة إلى المبلغ. |
| Payment window, minutes | مدة صلاحية صفحة الدفع (1–1440، الافتراضي 60). رابط «Pay for order» يفتح لاحقًا صفحة جديدة. |
| USD for 1 … | فقط إذا كانت عملة المتجر غير USD: سعر التحويل لفواتير SnapEX Pay. |
| Test mode | فواتير تجريبية لمديري المتجر فقط. بعد إيقاف الوضع لا تُطبَّق الدفعات التجريبية أبدًا. |
| Partner ID | اختياري: Partner ID للمُدمِج الذي أعدّ الوحدة (برنامج الإحالة في SnapEX Pay). اتركه فارغًا إذا أعددتها بنفسك. |
أسئلة
ما العملات التي يمكن أن يستخدمها المتجر؟
فواتير SnapEX Pay بعملة USD. المتاجر بعملة USD تعمل كما هي؛ أما للعملات الأخرى فاضبط السعر في الإعدادات أو حوّل المبلغ عبر المرشِّح snapexpay_wc_amount_usd.
هل تعمل مع كتلة Checkout الجديدة؟
نعم: كتلة Checkout، وصفحة الدفع الكلاسيكية، وروابط «Pay for order». وهي متوافقة مع HPOS ومع التخزين القديم للطلبات.
ماذا يحدث بعد نجاح الدفع؟
تُستدعى الدالة payment_complete() في WooCommerce: تنتقل حالة الطلب إلى Processing (أو Completed للمنتجات الافتراضية أو القابلة للتنزيل)، ويُخفَّض المخزون، وتُرسَل الرسائل المعتادة. معرّف المعاملة هو معرّف فاتورة SnapEX Pay.
ماذا لو أرسل العميل أقل من إجمالي الطلب؟
إذا لم يُكمل العميل المبلغ في الوقت المحدد، تنتقل حالة الطلب إلى On hold مع ملاحظة لمراجعته في لوحة تحكم SnapEX Pay.
هل يمكنني رد الأموال من WooCommerce؟
لا. يتم الاسترداد من لوحة تحكم SnapEX Pay.
ما البيانات التي ترسلها الإضافة؟
لإنشاء فاتورة ترسل مبلغ الطلب بعملة USD، ومرجع الطلب، واسم المتجر ورقم الطلب، ورابطي العودة والإلغاء (يتضمنان مفتاح الطلب)، وإعدادات الدفع، وPartner ID إن كان مضبوطًا. لا يُرسَل اسم العميل ولا بريده الإلكتروني ولا عنوانه ولا عنوان IP الخاص به.
هل أنت مستعد لقبول العملات المشفرة؟
أنشئ حساب تاجر، واحصل على مفتاح API، ثم اربط الوحدة. عمولة 1% على كل دفعة، دون رسوم شهرية.