إضافة الدفع المربع
The MEC Square Payment Addon is a powerful integration tool that connects your Modern Events Calendar (MEC) with the secure Square Payment system. This allows you to process ticket sales directly through Square, providing a seamless and professional checkout experience for your attendees.
الإعداد الأولي
قبل البدء بعملية التكامل، تأكد من أن بيئتك تفي بالمتطلبات التالية:
- MEC Pro: This addon requires the Pro version of Modern Events Calendar.
- إصدار MEC: This addon requires Modern Events Calendar 7.38.0 أو أحدث.
- وحدة الحجز: انتقل إلى إعدادات MEC > الحجز وتأكد من أن تفعيل وحدة الحجز تم تفعيل خيار التبديل. يجب عليك حفظ التغييرات وتحديث الصفحة حتى تظهر خيارات بوابة الدفع.
- تركيب: تأكد من تثبيت وتفعيل كل من MEC Pro و Square Payment Addon على موقع WordPress الخاص بك.
اقرأ أيضا:
كيفية تثبيت MEC والإضافات؟إنشاء حساب مطور Square الخاص بك
لربط الأنظمة، يجب عليك أولاً إنشاء ملف تعريف للمطور على موقع Square الإلكتروني.

- سجل: قم بزيارة صفحة التسجيل في خدمة الدفع الإلكتروني Square Payment.
- بيانات اعتماد الحساب: ادخل البريد الإلكتروني، إنشاء كلمة المرورثم اختر ما يناسبك مكان (على سبيل المثال، الولايات المتحدة (الإنجليزية)) من القائمة المنسدلة.
- الاتفاق: ضع علامة في المربع للموافقة على شروط سكوير الشروط وسياسة الخصوصية وموافقة التوقيع الإلكتروني، ثم اضغط إنشاء حساب.
- تفاصيل العمل: ادخل الإسم , اسم العائلةو الاسم التجارييمكنك أيضًا تقديم موقع إلكتروني للشركة (اختياري) قبل النقر معتينو.

نصيحة احترافية: عند سؤالك " كيف تحب البرمجة؟ "، انقر فوق زر "تخطي" للمتابعة إلى إعداد التطبيق.
تكوين تطبيق سكوير
بمجرد أن يصبح حسابك جاهزًا، يجب عليك إنشاء تطبيق محدد لإنشاء مفاتيح API اللازمة.

- اسم طلبك: أدخل قيمة واضحة اسم التطبيق في المجال المقدم.
- شروط المطور: حدد المربع الخاص بـ شروط خدمة مطوري Square ثم انقر اتبع الدورة.

3. تحديد الأهداف: سيُطلب منك تحديد "ماذا ستبني أولاً؟". يمكنك اختيار خيارات مثل قبول المدفوعات أو إدارة الطلبات وتنفيذها ، أو ببساطة النقر على "تخطي".

التكامل والبيانات المعتمدة
After creating your application, you must transfer the security credentials to your Modern Events Calendar (MEC).
استخراج بيانات الاعتماد من سكوير
التبديل بين رمل (لأغراض الاختبار) و الإنتــاج (للمعاملات الحقيقية) في أعلى الصفحة.
تلميح احترافي: يجب أن يكون طلبك في الإنتــاج طريقة لتلقي المدفوعات الفعلية في حسابك المصرفي.
1. مفاتيح واجهة برمجة التطبيقات: نسخ معرف التطبيق و مبادئ السلوك رمز وصول.

2. معرّف الموقع: انتقل إلى علامة تبويب المواقع في الشريط الجانبي لـ Square . انسخ معرّف الموقع المحدد المرتبط بعنوان عملك.

تهيئة إعدادات MEC
انتقل إلى إعدادات MEC > الحجز > بوابة الدفع > سكوير وأدخل ما يلي:

- معرف التطبيق
- رمز الوصول (the field is masked like a password; click إظهار / إخفاء next to it to reveal or hide the token)
- معرف الموقع
- المعالم (الإنتــاج for real payments or رمل for testing; it must match the mode of the credentials you copied from Square)
The gateway is only offered at checkout when the مربع checkbox is enabled and معرف التطبيق, رمز الوصول و معرف الموقع are all filled in. Once the Access Token is saved, the settings show “Access token is correct!” or the error returned by Square.
نصيحة احترافية: تأكد من أن العملة المُحددة لموقعك في سكوير تُطابق العملة المُختارة لفعالياتك في إعدادات MEC > عام > العملة . في حال عدم التطابق، ستفشل عمليات الدفع.
حالات الاستخدام (متى تكون هذه الإضافة مفيدة)
- بيع التذاكر عبر الإنترنت بشكل آمن: يوفر بيئة موثوقة ومشفرة للحضور لدفع ثمن الفعاليات باستخدام بطاقات الائتمان.
- نظام تتبع مالي آلي: يُركز هذا النظام جميع إيرادات التذاكر داخل لوحة تحكم Square الخاصة بك لتسهيل المحاسبة.
- الخروج مبسطة: يقلل من الاحتكاك من خلال السماح للمستخدمين بالدفع مباشرة على موقعك دون إعادة توجيههم إلى صفحات خارجية غير مألوفة.
قد لا تكون هذه الإضافة مثالية في بعض الحالات
- المستخدمون غير المحترفين: This addon will not function if you are only using the Lite version of Modern Events Calendar.
- العملات غير المدعومة: إذا لم تكن عملتك المحلية مدعومة من قبل Square أو لم تتطابق مع إعدادات MEC الخاصة بك، فسيفشل التكامل.
- فعاليات حضورية فقط: إذا كنت تقبل فقط المدفوعات النقدية أو المدفوعات في الموقع، فإن دمج هذه البوابة الرقمية غير ضروري.
استكشاف الأخطاء وإصلاحها للمبتدئين
- فشل عمليات الدفع: تأكد مرة أخرى من أن عملة MEC يطابقك عملة الموقع المربعةحتى عدم التطابق البسيط (مثل الدولار الأمريكي مقابل الدولار الكندي) سيمنع إتمام المعاملة.
- عدم استلام الأموال: تأكد من تفعيل تطبيق Square الخاص بك الإنتــاج mode and that المعالم in the MEC Square settings is set to الإنتــاج. If it is in رمل، المعاملات محاكاة فقط ولا يتم تحويل أي أموال حقيقية.
- لم يتم حفظ بيانات الاعتماد: إذا لم تقبل الحقول في MEC مفاتيحك، فتأكد من عدم نسخ أي مسافات إضافية في بداية أو نهاية معرف التطبيق or رمز الوصول.
- Addon Not Working After Update / MEC Is Too Old: If MEC is older than 7.38.0, the addon does not load and administrators see the notice “One or more MEC addons require Modern Events Calendar 7.38.0 or later and are temporarily disabled. Update MEC first, then the addons will start working again.” Update MEC first; the Square gateway will then work again.
- “Request to payment server failed.”: The checkout could not get a response from Square’s servers. Try again, and if it keeps happening check that your hosting allows outgoing connections from WordPress to Square.