استقبال مدفوعات البطاقات في فلسطين عبر Lahza

Lahza مزوّد خدمات دفع للتجّار في فلسطين. وعند ربط حسابك الخاص لدى Lahza يستطيع متجرك استقبال مدفوعات البطاقات بالشيكل الإسرائيلي (ILS) أو بالدولار الأمريكي (USD). يدفع المشتري في صفحة الدفع المستضافة لدى Lahza، فلا تصل أرقام البطاقات إلى متجرك إطلاقًا، وتذهب الأموال إلى حسابك لدى Lahza لا إلى VeloCMS. يشرح هذا الدليل ما تحتاجه من Lahza، وأين تضعه، وما الذي تتوقعه من وضع الاختبار والانتقال إلى الإنتاج والمبالغ المستردة.

ما الذي تحتاجه من Lahza

• حساب تاجر لدى Lahza. لا تعمل مفاتيح الإنتاج إلا بعد أن تفتح لك Lahza حسابًا فعّالًا، وهذه خطوة منفصلة تتم لدى Lahza.
• مفتاحك السري لواجهة البرمجة من لوحة تحكم Lahza. يوجد مفتاح اختبار ومفتاح إنتاج، والمطلوب هو المفتاح السري فقط.

لا يحدد VeloCMS رسوم Lahza ولا مواعيد تحويل الأموال. يُتَّفق على الأمرين بينك وبين Lahza، فاسألها عنهما قبل الانتقال إلى الإنتاج.

الصق مفتاحك في VeloCMS

1. انتقل إلى لوحة التحكم ← الإعدادات ← التجارة وافتح قسم Lahza.
2. الصق مفتاحك السري في حقل المفتاح السري. يُحفظ مشفّرًا ولا يُعرض مرة أخرى بعد الحفظ. إن أردت لاحقًا الإبقاء على المفتاح المحفوظ فاترك الحقل فارغًا.
3. اختر الوضع المطابق للمفتاح (انظر وضع الاختبار والإنتاج أدناه) ثم اضغط حفظ.
4. اضغط فحص الاتصال. يرسل هذا الإجراء طلب قراءة واحدًا إلى Lahza بمفتاحك المحفوظ. وإذا فشل فلا يحدد سبب الفشل، أهو مفتاح خاطئ أم رفضٌ للطلب لسبب آخر؛ ولذلك فإن عملية شراء تجريبية فعلية هي الفحص الشامل الوحيد.

أضف رابط الويب هوك

يعرض القسم نفسه رابط الويب هوك الخاص بمتجرك مع زر نسخ. الصقه في إعدادات الويب هوك بلوحة تحكم Lahza، مرة للاختبار ومرة للإنتاج. الويب هوك هو الطريقة التي تُبلغ بها Lahza متجرك بنجاح الدفع، حتى حين يغلق المشتري التبويب قبل عودته إلى موقعك. ويتحقق VeloCMS من كل عملية دفع لدى Lahza باستخدام مفتاحك أنت قبل أن يضع علامة «مدفوع» على الطلب، فالويب هوك ينبّه المتجر إلى إجراء هذا التحقق فقط، ولا يستطيع بمفرده أن يجعل طلبًا مدفوعًا.

ويعرض القسم أيضًا وقت وصول آخر ويب هوك. فإن ظلّ يذكر أنه لم يصل أي ويب هوك بعد أول عملية شراء تجريبية، فهذا يعني أن الرابط لم يُضبط بعدُ لدى Lahza.

وضع الاختبار ووضع الإنتاج

• يتطلب مفتاح الاختبار تفعيل وضع الاختبار، ويتطلب مفتاح الإنتاج إيقافه. يرفض VeloCMS حفظ مفتاح لا يطابق الوضع (يبدأ مفتاح الاختبار بـ sk_test_).
• ما دام وضع الاختبار مفعّلًا يظهر زر Lahza لك أنت فقط وأنت مسجّل الدخول إلى موقعك، ولا يراه المشترون أبدًا، فلا يمكن لإعداد غير مكتمل أن يستقبل طلبات حقيقية.
• مدفوعات الاختبار ليست أموالًا حقيقية، والطلب المُنشأ في وضع الاختبار ليس عملية بيع حقيقية.
• للتأكد من سلامة المسار كاملًا، اشترِ شيئًا من متجرك وأنت مسجّل الدخول باستخدام بطاقة اختبار من وثائق Lahza، ثم تحقق من ظهور الطلب في لوحة التحكم ← الطلبات بحالة «قيد المعالجة» (Processing).
• للانتقال إلى الإنتاج، الصق مفتاح الإنتاج وأوقف وضع الاختبار ثم احفظ. تحتاج Lahza إلى حساب فعّال قبل أن تعمل مفاتيح الإنتاج.

قائمة Lahza للانتقال إلى الإنتاج

قبل أن توافق Lahza على حساب إنتاج، تراجع موقعك. تشمل قائمة Lahza للانتقال إلى الإنتاج (docs.lahza.io/guide/go-live-checklist) ما يلي باختصار: موقعًا إلكترونيًا فعّالًا على عنوان صالح مع شهادة SSL؛ وشعارك وشعارات شبكات البطاقات في تذييل الصفحة؛ وبيانات التواصل؛ وسياسات الخصوصية والاسترداد والإرجاع والشحن؛ وسلة تسوّق تعمل مع حقول عنوان المشتري؛ وعدم وجود حقول بطاقات في موقعك؛ وإيصال شراء يُرسل بالبريد الإلكتروني؛ وحماية من الروبوتات عند الدفع. قد تغيّر Lahza هذه القائمة، فاقرأ الصفحة الحالية واسأل Lahza إن لم يتضح لك أمر ما. وقرار الموافقة على مراجعتك يعود إلى Lahza وحدها.

المبالغ المستردة تستغرق وقتًا

استرد مبلغ طلب Lahza من شاشة تفاصيل الطلب في لوحة التحكم ← الطلبات، كاملًا أو جزئيًا. تعالج Lahza المبالغ المستردة بصورة غير متزامنة: يوضع طلبك في قائمة الانتظار أولًا، ثم تتحرك الأموال لاحقًا. ولذلك ينتظر VeloCMS تأكيد Lahza قبل أن يغيّر أي شيء من جانبك.

• ما دام الاسترداد قيد الانتظار تبقى حالة الطلب كما هي: لا يُعاد المخزون ولا يُسحب وصول المشتري.
• حين تؤكد Lahza الاسترداد ويبلغ مجموع المبالغ المستردة المؤكدة إجمالي الطلب كاملًا، يعيد VeloCMS المخزون ويُلغي وصول المشتري إلى ما تلقّاه، ويرسل إليه بريدًا إلكترونيًا.
• إذا أبلغت Lahza بفشل الاسترداد، يبقى الطلب مدفوعًا ويصلك إشعار بذلك. أعد المحاولة أو نفّذ الاسترداد من لوحة تحكم Lahza.
• الاسترداد الذي تبدأه من لوحة تحكم Lahza نفسها يصل إلى متجرك عبر الويب هوك نفسه.

ما لا يقوم به خيار Lahza

• لا اشتراكات للقرّاء ولا اشتراكات دورية متكررة. استخدم Stripe أو PayPal أو Lemon Squeezy لها.
• الشيكل (ILS) والدولار (USD) فقط. إن كانت عملة متجرك غيرهما فلن يظهر زر Lahza عند الدفع حتى تصبح عملة المتجر ILS أو USD.
• لا رموز خصم ولا بطاقات هدايا عند الدفع عبر Lahza. يُطلب من المشتري الذي أضاف رمزًا أو بطاقة هدية إلى سلته أن يزيلها ليتمكن من الدفع عبر Lahza.
• لا معلومات عن الرسوم أو مواعيد التحويل. اسأل Lahza.