مدفوعات العملات المشفرة لـ CS-Cart
اقبل العملات المشفرة في CS-Cart. يختار العميل Crypto عند إتمام الطلب، ويدفع على صفحة SnapEX Pay بـ USDT على شبكات TRON وEthereum وBSC وغيرها، أو بعملات أخرى تُحوَّل إلى USDT، فتنتقل حالة الطلب إلى Processed تلقائيًا.
مجانًا. الإصدار 1.1.0.
ماذا تفعل الوحدة
- لا محافظ ولا عُقد تحتاج إلى تشغيلها: تصل الأموال إلى رصيد التاجر الخاص بك في SnapEX Pay.
- CS-Cart وCS-Cart Multi-Vendor: في Multi-Vendor يُدفع الطلب الذي يضم عدة بائعين مرة واحدة؛ تُسوّي الإضافة الطلب الأصلي، وينقل CS-Cart الحالة إلى طلبات البائعين.
- أربع طرق مستقلة لتسوية الطلب: إشعار Webhook الموقّع، وعودة العميل من صفحة الدفع، وفحص اختياري عبر cron (كل دفعة معلّقة مرة كل 10 دقائق على الأكثر، لمدة 5 أيام)، وفتح المشرف للطلب. ضياع إشعار Webhook لا يترك طلبًا مدفوعًا دون تسجيل أبدًا، ولا تُطبَّق أي دفعة مرتين.
- يُقرأ المبلغ دائمًا من جديد عبر API الخاص بـ SnapEX Pay؛ ومحتوى إشعار Webhook وحده لا يغيّر أي طلب أبدًا.
- وضع الاختبار: تُؤكَّد الفواتير التجريبية من تلقاء نفسها دون أموال حقيقية.
التثبيت
- افتح Add-ons → Manage add-ons → + (Upload & install add-on) وارفع
snapexpay-cscart-1.1.0.zip. (أو انسخapp/وdesign/وvar/إلى المجلد الجذر للمتجر، وثبّت SnapEX Pay من القائمة.) - افتح Administration → Payment methods → + واختر المعالج SnapEX Pay (crypto)، والقالب
cc_outside.tpl، والاسم مثلًا «Crypto (USDT and other coins)». - في تبويب Configure الصق مفتاح API من لوحة تحكم التاجر في SnapEX Pay (بالصلاحيتين
invoices.readوinvoices.write). - Webhook (يُنصح به): في لوحة التحكم اضبط عنوان Webhook المعروض تحت Webhook secret (
https://<store>/index.php?dispatch=payment_notification.webhook&payment=snapexpay)، والصق السرwhsec_…. - اختياري: أضف سطر cron المعروض تحت Payment check إلى crontab الخادم.
- الاختبار: فعّل Test mode، واجعل طريقة الدفع متاحة لمجموعة مستخدمين تجريبية فقط، وضع طلبًا، وادفعه على صفحة SnapEX Pay بطريقة تجريبية، وتحقّق من أن حالته أصبحت Processed. ثم أوقف وضع الاختبار.
الإعدادات
| API key | من لوحة تحكم SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… من إعدادات Webhook في لوحة التحكم. من دونه تُسوّى الطلبات مع ذلك عند عودة العميل، وعبر الفحص بـ cron، وعندما يفتح المشرف الطلب. |
| Network fee paid by | Merchant: يدفع العميل إجمالي الطلب بالضبط، وتُخصم الرسوم مما تستلمه. Customer: تُضاف عمولة SnapEX Pay ورسوم الشبكة إلى المبلغ. |
| Payment window, minutes | مدة صلاحية صفحة الدفع (1–1440، الافتراضي 60). إعادة الدفع لاحقًا تفتح صفحة جديدة. |
| Test mode | فواتير تجريبية. بعد إيقاف الوضع لا تُطبَّق الدفعات التجريبية أبدًا. |
| Partner ID | اختياري: Partner ID للمُدمِج الذي أعدّ الوحدة (برنامج الإحالة في SnapEX Pay). اتركه فارغًا إذا أعددتها بنفسك. |
أسئلة
هل تعمل مع CS-Cart Multi-Vendor؟
نعم. يُدفع الطلب الذي يضم عدة بائعين مرة واحدة: تُسوّي الإضافة الطلب الأصلي، وينقل CS-Cart الحالة إلى طلبات البائعين.
عملة متجري ليست USD. هل ستعمل الإضافة؟
نعم، إذا كانت USD ضمن عملات المتجر (ويمكن أن تكون ثانوية). يُحوَّل إجمالي الطلب بسعر USD المضبوط في المتجر نفسه (Administration → Currencies)، لذا أبقِ هذا السعر محدَّثًا.
ما حالات الطلب التي تضبطها الإضافة؟
Incomplete حتى يعود العميل، وOpen أثناء تأكيد الدفعة، وProcessed عند الدفع الكامل. الطلبات بحالة Open غير المدفوعة التي انتهت صلاحيتها تصبح Failed؛ أما الطلبات بحالة Incomplete فتبقى كما هي ليتمكن العميل من الدفع مجددًا.
ماذا لو أرسل العميل أقل من إجمالي الطلب؟
إذا لم يُكمل العميل المبلغ في الوقت المحدد، يغلق SnapEX Pay الفاتورة على أنها مدفوعة جزئيًا، وتُضبط حالة الطلب على Open مع ملاحظة لمراجعة الدفعة في لوحة تحكم SnapEX Pay وإكمال الطلب يدويًا.
هل يمكنني رد الأموال من CS-Cart؟
لا. يتم الاسترداد من لوحة تحكم SnapEX Pay.
ماذا يحدث إذا ألغيت تثبيت الإضافة؟
تُعطَّل طرق الدفع التي تستخدم SnapEX Pay وتُمسح إعدادات SnapEX Pay الخاصة بها؛ ويُحتفظ بجدول سجل الدفعات (snapexpay_invoices) لإعادة التثبيت لاحقًا.
هل أنت مستعد لقبول العملات المشفرة؟
أنشئ حساب تاجر، واحصل على مفتاح API، ثم اربط الوحدة. عمولة 1% على كل دفعة، دون رسوم شهرية.