دليل التثبيت
ثبّت Saudi Checkout Guard، وجهّز صفحة الدفع، ثم فعّل القواعد التي تحتاجها واختبرها. يمكنك الرجوع إلى هذا الدليل في أي وقت.
تظهر الشاشات في الصور بالإنجليزية، وترافقها تعليمات بالعربية. تشمل الصور صفحة التطبيق في متجر Shopify، ومتجرًا تجريبيًا، ومعاينة لإعدادات التطبيق. اضغط على أي صورة لتكبيرها.
يتحقق التطبيق من صيغة العنوان المختصر السعودي فقط. لا يتحقق من العنوان لدى سبل، ولا يؤكد هوية المقيم فيه، ولا يضمن التوصيل. يستخدم حقل العنوان الموجود في Shopify؛ لا تحتاج إلى تعديل كود القالب أو إضافة مكوّن إلى صفحة الدفع.
١. ثبّت التطبيق وافتحه
- افتح صفحة Saudi Checkout Guard في متجر تطبي قات Shopify واختر تثبيت. سجّل الدخول إلى المتجر المطلوب، وراجع الصلاحيات، ثم أكّد التثبيت.
- من لوحة تحكم Shopify، افتح التطبيقات > Saudi Checkout Guard، ثم اختر العربية أو English. إذا كان حساب الموظف لا يملك صلاحية تثبيت التطبيقات أو تعديل إعدادات الدفع، اطلب من مالك المتجر تنفيذ هذه الخطوات.
- عند التثبيت لأول مرة، تكون القواعد غير مفعّلة. أكمل الخطوات التالية قبل الاعتماد على التطبيق.
فتح صفحة التطبيق في متجر Shopify

افتح صفحة Saudi Checkout Guard في متجر تطبيقات Shopify واختر Install (تثبيت). تعرض الصفحة خططًا تبدأ من 4.99 دولار أمريكي شهريًا، مع تجربة مجانية. قارن بين الخطتين في الخطوة ٢.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)٢. اختر خطتك
- افتح الخطط في التطبيق. تشمل خطة Short Address فحص صيغة العنوان المختصر السعو دي مقابل 4.99 دولار أمريكي لكل متجر كل 30 يومًا. وتضيف خطة Guard + City Rules قواعد التوصيل لمدن سعودية تختارها، مقابل 14.99 دولار أمريكي لكل متجر كل 30 يومًا. تشمل الخطتان تجربة مجانية لمدة 14 يومًا للمتاجر الجديدة.
- اختر عرض الخطط وإدارة الاشتراك في Shopify، ثم اختر خطتك. راجع السعر والتجربة والرسوم المتكررة في شاشة الموافقة لدى Shopify قبل الموافقة. بعد العودة إلى التطبيق، تأكد من الخطة والميزات المشمولة ضمن حالة الوصول. إذا لم تتحدّث الحالة، اختر تحديث حالة الاشتراك أو تواصل مع الدعم.
- المتاجر التي كان التطبيق مثبتًا لديها عند إطلاق الخطط المدفوعة تحتفظ بفحص العنوان المختصر وقواعد المدن دون رسوم اشتراك. إذا أكّدت صفحة الخطط استمرار وصولك المجاني، تجاوز اختيار الخطة وأكمل الإعداد.
- اختيار الخطة لا يفعّل أي قاعدة. أكمل الخطوات التالية لحفظ إعداداتك وتفعيلها واختبارها. إذا كنت تحتاج إلى تطوير أو تنفيذ مخصّص، تواصل مع الدعم للحصول على عرض للشراكة المخصّصة قبل بدء العمل.

افتح الخطط في التطبيق للمقارنة بين Short Address وGuard + City Rules. اختر View plans and manage subscription in Shopify (عرض الخطط وإدارة الاشتراك في Shopify)، ثم اختر خطتك وراجع شاشة الموافقة لدى Shopify قبل القبول. الصورة من متجر تطوير.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)٣. جهّز سطر العنوان الثاني
- في لوحة تحكم Shopify، انتقل إلى الإعدادات > الدفع > معلومات العميل. اجعل سطر العنوان الثاني (الشقة أو الوحدة، إلخ) اختياريًا، ثم احفظ. أبقِ الحقل ظاهرًا. يسري هذا الإعداد على أسواق متجرك كلها، بينما تطلب قاعدة التطبيق المفعّلة العنوان المختصر لعناوين التوصيل داخل السعودية فقط.
- من الإعدادات > الدفع > لغة صفحة الدفع، اختر تعديل محتوى صفحة الدفع. راجع اسم سطر العنوان الثاني والنص التوضيحي داخله، وحدّث كل لغة يعرضها متجرك. وضّح أن العميل داخل السعودية يُدخل العنوان المختصر، وأن العميل خارجها يمكنه إدخال تفاصيل الشقة أو الوحدة. التطبيق لا يغيّر هذه النصوص نيابة عنك.
- للتوصيل داخل السعودية، يُدخل العميل في سطر العنوان الثاني أربعة أحرف إنجليزية تليها أربعة أرقام فقط، مثل RAGI2929. تُقبل الأحرف الإنجليزية الكبير ة والصغيرة. لا تُضف مسافات أو تفاصيل الشقة في هذا الحقل؛ ضع بقية تفاصيل العنوان في حقولها المناسبة.
اسم مقترح للحقل
العنوان المختصر (داخل السعودية) / الشقة أو الوحدة (خارج السعودية)
يجب أن يكون اسم الحقل واضحًا للعملاء خارج السعودية أيضًا. قد يعرض Shopify كلمة «اختياري» بسبب الإعداد العام، لكن القاعدة المفعّلة تتحقق من الرمز عند متابعة العميل داخل السعودية.

ضمن معلومات العميل، أبقِ سطر العنوان الثاني ظاهرًا واختر Optional (اختياري)، ثم احفظ أي تغيير. الصورة من متجر تجريبي.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)
بعد فتح Edit checkout content (تعديل محتوى صفحة الدفع)، ابحث عن address2 للوصول إلى Address2 label وOptional address2 label. راجع نص الحقل بكل لغة يعرضها متجرك.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)٤. احفظ إعدادات العنوان المختصر
- ارجع إلى صفحة العنوان المختصر في التطبيق. راجع رسالتي الدفع بالعربية والإنجليزية. تظهر الرسالة المناسبة عندما يترك العميل داخل السعودية الرمز فارغًا أو يُدخله بصيغة غير صحيحة.
- اختر حفظ إعدادات العنوان المختصر. عند إنشاء قاعدة جديدة، ينبغي أن تظهر حالة جاهز للتفعيل. حفظ قاعدة موجودة يُبقي حالة تفعيلها كما هي، لذلك تسري تعديلات القاعدة المفعّلة وهي ما تزال تعمل.

راجع رسالتي الدفع، ثم احفظ إعدادات العنوان المختصر. هذه معاينة للتطبيق ببيانات تجريبية.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)٥. فعّل الحماية واختبر الدفع
اختر وقتًا هادئًا تستطيع فيه فحص صفحة الدفع فورًا. اختر تفعيل حماية الدفع، وتأكد من ظهور الحالة مفعّل. بعدها افتح عملية دفع جديدة تحتوي على منتج يتطلب الشحن. استخدم بيانات تجريبية وتوقّف قبل الدفع؛ لا تحتاج إلى إنشاء طلب لإجراء هذه الاختبارات.
- اختر السعودية وأدخل RAGI2929 في سطر العنوان الثاني: ينبغي أن تسمح لك قاعدة العنوان المختصر بالمتابعة.
- اختر السعودية واترك الرمز فارغًا، أو أدخل ABC123، أو رمزًا يتضمن مسافات: ينبغي أن تظهر الرسالة المحددة وألا تتمكن من المتابعة حتى تصحح الرمز.
- إذا كنت تشحن خارج السعودية، اختبر إحدى تلك الوجهات مع ترك سطر العنوان الثاني فارغًا، ثم مع إدخال تفاصيل شقة. ينبغي ألا تمنع قاعدة العنوان المختصر أيًا من الحالتين.
- كرّر الاختبارات بالعربية والإنجليزية، على الجوال والكمبيوتر، وبعد الرجوع إلى السلة. اختبر العناوين المحفوظة وخيارات الدفع السريع التي توفرها فعليًا. إذا لم تُتِح المحفظة تصحيح العنوان، تواصل مع الدعم قبل الاعتماد على هذا المسار.
جاهز للتفعيل تعني أن الإعدادات محفوظة وأن القاعدة لم تبدأ العمل. اجتياز اختبار الصيغة لا يثبت وجود العنوان. إذا أخفق أي اختبار، أوقف حماية الدفع مؤقتًا وتأكد من عودة الدفع للعمل، ثم تواصل مع الدعم.

تظهر القاعدة المحفوظة بحالة جاهز للتفعيل. اختر تفعيل حماية الدفع عندما تكون مستعدًا للاختبار. هذه معاينة ببيانات تجريبية.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)
مثال من اختبار الدفع: الرمز RAGI292 ينقصه رقم، لذلك تظهر رسالة تنبيه. قد يختلف نص الرسالة في متجرك. استخدم بيانات تجريبية وتوقّف قبل الدفع.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)٦. اختياري: حدّد مدن التوصيل لكل خيار شحن
- قواعد توصيل المدن متاحة في خطة Guard + City Rules. كما تبقى متاحة دون رسوم اشتراك للمتاجر التي كان التطبيق مثبتًا لديها عند إطلاق الخطط المدفوعة. افتح توصيل المدن. ضمن قواعد خيارات الشحن، اختر تعديل القاعدة لخيار الشحن الذي تريد تغييره، أو إضافة قاعدة شحن لخيار آخر. إذا لم تحفظ أي قاعدة بعد، ابدأ بنموذج قاعدة شحن جديدة. لكل قاعدة خيار شحن ومدن وحالة تفعيل مستقلة.
- انسخ اسم طريقة توصيل موجودة كما يظهر تمامًا في إعدادات الشحن في Shopify، وأدخله في القاعدة المحددة. حدّد أولًا اسم الخيار وسعره ومدة التوصيل في Shopify. لا ينشئ التطبيق طريقة جديدة ولا يغيّر سعرها أو مدة التوصيل.
- ابحث عن المدن بالعربية أو الإنجليزية، وأضف المدن التي تغطيها خدمة التوصيل لهذا الخيار فقط. تتضمن كل مدينة مجموعة محددة من الصيغ الشائعة لاسمها بالعربية والإنجليزية، ولا تحتاج إلى كتابتها بنفسك.
- اختر حفظ إعدادات توصيل المدن. تبقى القاعدة الجديدة غير مفعّلة حتى تختار تفعيل التحكم في توصيل المدن؛ تأكد عندها من تفعيل هذه القاعدة واختبرها فورًا. حفظ قاعدة موجودة يُبقي حالة تفعيلها كما هي، لذلك تسري تعديلات القاعدة المفعّلة على صفحة الدفع. احفظ تغييراتك أو تجاهلها قبل الانتقال إلى قاعدة أخرى. كرّر الخطوات لكل خيار شحن تريد التحكم فيه.
- اختبر لكل قاعدة مفعّلة مدينة سعودية ضمن تغطيتها، وأخرى خارج قائمة مدنها، ووجهة خارج السعودية إن كنت تخدمها. ينبغي أن يتاح خيار الشحن المحدد للمدن السعودية التي أعددتها في هذه القاعدة فقط، مع استمرار تطبيق بقية شروط الشحن في Shopify. تأكد من وجود طريقة توصيل أخرى مناسبة حيث تحتاجها.
- راجع الاسم في القاعدة إذا غيّرت اسم طريقة التوصيل. الاسم الجديد لن يطابق القاعدة، وقد تبقى الطريقة ظاهرة. أما كتابة اسم مدينة بصيغة غير مقبولة فتُخفي الطريقة المطابقة فقط. لا يغيّر التطبيق بقية طرق التوصيل أو أسعارها.

تُظهر المعاينة قاعدتين تجريبيتين: للتوصيل المبرد، وللتوصيل إلى جدة خلال يوم أو يومي عمل. لكل قاعدة مدنها وحالة تفعيلها؛ والقاعدتان هنا غير مفعّلتين. أسماء ا لخدمات ومدد التوصيل أمثلة، وتحددها أنت في إعدادات الشحن في Shopify.
فتح الصورة بالحجم الكامل (في علامة تبويب جديدة)تواصل مع الدعم
راسلنا إذا احتجت مساعدة في التثبيت، أو كان لديك استفسار عن الفوترة، أو واجهت سلوكًا غير متوقع في صفحة الدفع. نهدف إلى الرد خلال يومي عمل في السعودية.
اذكر نطاق متجرك المنتهي بـ .myshopify.com، والخطوة أو القاعدة المعنية، ووقت حدوث المشكلة، وأرفق لقطة شاشة بعد إزالة معلومات العملاء منها.
لا ترسل أسماء العملاء أو عناوينهم أو رموز العنوان المختصر أو بيانات الدفع أو كلمات المرور أو رموز الوصول أو رموز التحقق.
إيقاف التطبيق مؤقتًا أو إزالته
- لإيقاف حماية الدفع فورًا، اختر إيقاف حماية الدفع مؤقتًا من صفحة العنوان المختصر. وإذا كانت المشكلة في توصيل المدن، فافتح توصيل المدن واختر تعديل القاعدة لخيار الشحن المتأثر، ثم إيقاف التحكم في توصيل المدن مؤقتًا. يوقف هذا الإجراء قاعدة المدن المحددة فقط. تأكد من أن القاعدة المتأثرة غير مفعّلة، واختبر عودة الدفع وخيارات التوصيل للعمل.
- لإزالة التطبيق، أوقف حماية العنوان المختصر وكل قاعدة مفعّلة لتوصيل المدن أولًا، ثم احذف Saudi Checkout Guard من الإعدادات > التطبيقات وقنوات البيع في Shopify. إيقاف القواعد وحده لا يلغي الاشتراك المدفوع. إلغاء التثبيت يوقف دورات الفوترة المستقبلية عبر Shopify، لكن الرسوم التي أُنشئت مسبقًا قد تظل ظاهرة في فاتورة لاحقة. إذا تعذّر فتح التطبيق، تواصل مع الدعم أو استخدم لوحة تحكم Shopify لإدارة القاعدة المتأثرة.
- بعد الإزالة، اختبر الدفع بعنوان سعودي وآخر خارج السعودية إن كان متاحًا. إعداد الحقل والنصوص التي عدّلتها يدويًا تبقى في Shopify؛ راجعها بشكل منفصل. تواصل مع الدعم إذا ظلت إحدى قواعد التطبيق ظاهرة.