تظهر عبارة «تعذر إتمام الدفع» في متجر إلكتروني، فيعيد المشتري الضغط على الزر، بينما يبحث فريق الدعم عن طلب لا يعرف هل رُفض أم ما زال قيد المعالجة؛ هنا لا تكمن المشكلة في ترجمة جملة إنجليزية فقط، بل في رسالة تطلب تصرفًا قد يكون غير مناسب لحالة العملية
رسائل الخطأ العربية في الدفع ينبغي أن تفرق بين ما يعرفه المتجر وما لا يعرفه بعد؛ خطأ في تاريخ انتهاء البطاقة يحتاج تصحيح الحقل، ورفض من جهة الإصدار يحتاج مسارًا مختلفًا، وانقطاع الاتصال بعد إرسال الطلب يحتاج تحققًا من الحالة قبل دعوة العميل إلى محاولة أخرى
هذا الدليل موجه إلى مسؤولي المتاجر وفرق المحتوى والتطوير والدعم الذين يريدون صياغة رسائل مفهومة وتشخيص التعثر دون كشف بيانات حساسة؛ الأمثلة التالية صيغ تحريرية مقترحة وليست رسائل رسمية موحدة لكل بنك أو بوابة، ويجب ربط كل صيغة بالحالة الفعلية التي يعيدها مزود الدفع
ابدأ بالسؤال الصحيح: هل فشلت العملية أم غاب تأكيدها؟
فشل عرض صفحة التأكيد لا يثبت فشل الدفع؛ قد يصل الطلب إلى مزود الخدمة ثم ينقطع اتصال المتصفح قبل عودة الرد، وقد يغلق العميل صفحة المصادقة، وقد تنجح العملية بينما يتأخر تحديث حالة الطلب داخل المتجر؛ هذه احتمالات مختلفة لا يصح جمعها تحت تفسير واحد
لذلك افصل ثلاث طبقات في التشخيص: ما الذي حدث داخل واجهة المشتري، وما الحالة المسجلة لدى مزود الدفع، وما الحالة التي يحتفظ بها نظام الطلبات؛ عندما تختلف الطبقات، لا تختَر الحالة الأكثر طمأنة أو الأكثر تشاؤمًا، بل تعامل مع الاختلاف باعتباره معلومة تحتاج مصالحة قبل عرض نتيجة نهائية
يمكن أن تقول الواجهة «نتحقق من حالة الدفع، لا تبدأ محاولة جديدة الآن» إذا كان النظام يتحقق بالفعل ويملك طريقًا لإظهار النتيجة أو متابعتها؛ أما عرض العبارة من دون عملية تحقق حقيقية فينقل الغموض إلى العميل ولا يعالجه، وقد يجعله ينتظر نتيجة لن تصل
تشرح وثائق ميسر لمنع تكرار الطلبات لماذا قد يكون انقطاع الشبكة أو بعض أخطاء الخادم ملتبس النتيجة؛ هذا هو موضع الحاجة إلى معالجة تقنية تمنع تكرار التنفيذ، وليس مجرد استبدال نص زر المحاولة
قسّم الرسائل بحسب المسؤول عن الخطوة التالية
أفضل تقسيم عملي لا يبدأ بعدد رموز الأخطاء، بل بمن يستطيع فعل شيء مفيد؛ هناك بيانات يستطيع المشتري تصحيحها، وقرارات تعود إلى جهة الإصدار، ومصادقة تتم في سياق مستقل، وأعطال تكامل يعالجها المتجر، وحالات غير محسومة تتطلب انتظار نتيجة موثوقة
هذا التصنيف لا يعني أن السبب النهائي معروف دائمًا؛ يمكن للواجهة تحديد الخطوة الآمنة دون اختلاق تشخيص تفصيلي، مثل إبلاغ العميل بأن الجهة المصدرة لم توافق على العملية، مع إتاحة وسيلة دفع أخرى إذا كان ذلك مناسبًا لحالة نهائية مؤكدة
تجنب تحميل المشتري مسؤولية كل تعثر؛ رسالة «تحقق من بياناتك» لا تساعد إذا كان الخطأ متعلقًا بإعداد حساب التاجر، ورسالة «تواصل مع البنك» لا تصلح لكل مشكلة اتصال، كما أن عبارة «جرب لاحقًا» تخفي عيبًا دائمًا إذا كانت إعدادات التكامل غير صحيحة
في الجهة المقابلة، لا تعرض للمشتري التفاصيل الداخلية كلها؛ الرمز التقني قد يكون مفيدًا في سجل الدعم، لكنه لا يحل محل لغة توضح ما حدث وما يمكن فعله الآن، ولا ينبغي أن يكشف معلومات أمنية أو استنتاجات غير مؤكدة عن البطاقة أو صاحبها
رسائل الخطأ العربية في الدفع: معلومة وخطوة وحدود واضحة
اختبر كل رسالة بثلاثة أسئلة: ماذا عرف المستخدم من النص، وماذا يستطيع أن يفعل بعده، وما الذي لم ندّع معرفته؟ إذا كانت الجملة لا تجيب عن السؤالين الأولين أو تتجاوز الأدلة في الثالث، فهي بحاجة إلى إعادة صياغة حتى لو كانت سليمة نحويًا
مثلًا، «بيانات غير صحيحة» لا تحدد الحقل المطلوب، بينما «راجع تاريخ انتهاء البطاقة ثم أعد الإرسال» أكثر فائدة عندما يثبت فحص الحقل وجود مشكلة في التاريخ؛ لا تستخدم هذا المثال عند رفض عام لا يحدد المزود فيه سببًا يمكن نسبته إلى التاريخ
أما «فشل الدفع بسبب البنك» فتجمع بين اتهام واسع وسبب قد لا يكون ثابتًا؛ صيغة «لم توافق جهة إصدار البطاقة على هذه العملية» أدق عندما تكون الحالة فعلًا رفضًا صادرًا عنها، لكنها تحتاج إجراءً مناسبًا مثل اختيار وسيلة أخرى أو مراجعة جهة الإصدار، وفق سياسة المزود وتصنيف الحالة
يفصل معيار W3C لتحديد أخطاء الإدخال بين مجرد إبراز المشكلة وبين وصفها نصيًا؛ ويضيف معيار اقتراح التصحيح أهمية تقديم إرشاد معروف عندما لا يضر بالأمان، فلا يكفي تحويل إطار الحقل إلى اللون الأحمر
أخطاء الإدخال: اقترب من الحقل ولا تكشف محتواه
عندما يكون الخطأ محليًا قبل إرسال بيانات الدفع، اجعل الرسالة ملاصقة للحقل المعني مع ارتباط برمجي يسمح بفهمها باستخدام التقنيات المساعدة؛ يجب أن يعرف العميل هل المشكلة في نقص معلومة مطلوبة أم في تنسيق لا يقبله النموذج، بدل إعادة تعبئة كل الحقول بالتخمين
لا تعرض رقم البطاقة داخل رسالة الخطأ، ولا تنسخه إلى عنوان الصفحة أو رابط المتصفح أو أدوات التحليل؛ يمكن إرشاد العميل إلى مراجعة الرقم من دون إعادة طباعته، وتبقى معالجة البيانات الحساسة ضمن مكونات الدفع ومسارات التخزين المصرح بها لا ضمن النصوص التحريرية أو سجلات المحتوى
راجع أيضًا طريقة تعامل الحقول مع اللصق والمسافات والأرقام؛ قد يكتب المستخدم أرقامًا عربية أو ينسخ رقمًا يتضمن مسافات، لكن قبول تلك الصيغ أو تحويلها يعتمد على مكون الدفع؛ المطلوب اختبار السلوك الفعلي لا كتابة وعد عام بأن كل تنسيق مدعوم
تاريخ الانتهاء مثال آخر على ضرورة الفصل بين التوضيح والافتراض؛ بيّن الصيغة المطلوبة بوضوح، ولا تجعل محاذاة الشهر والسنة في واجهة RTL مربكة، وإذا رفضت قيمة سابقة فلا تمسح السلة أو بيانات الشحن غير الحساسة لمجرد خطأ في حقل الدفع
عند الخطأ في رمز الأمان، تجنب رسائل الدعم التي تطلب إرساله في محادثة؛ هذا الرمز ليس وسيلة لتوثيق البلاغ، ولا ينبغي حفظه في لقطات الشاشة أو سجلات التشخيص؛ اطلب بدلًا منه مرجع الطلب والمعلومات التشغيلية غير الحساسة التي تسمح للفريق بالعثور على المحاولة
رفض جهة الإصدار: لا تحوّل الاحتمال إلى حقيقة
قد يعيد مزود الدفع سببًا واضحًا، وقد يكتفي برفض غير مفصل؛ لا يجوز للنص أن يملأ الفراغ بتفسير مثل نقص الرصيد أو الاشتباه بالاحتيال إذا لم يكن ذلك هو التفسير المسموح بعرضه في الحالة المحددة، فالمشتري قد يقرأه بوصفه حكمًا على حسابه
توفر وثائق أخطاء الدفع لدى ميسر أمثلة متعددة لأسباب التعثر، لكن وجود السبب في الوثائق لا يعني أنه ينطبق على كل عملية؛ اربط الرسالة بالقيمة التي وصلت فعلًا وبقواعد العرض المعتمدة لدى مزودك، لا بتخمين موظف الدعم
إذا كانت العملية مرفوضة نهائيًا ويمكن استخدام بديل، قدم الخيار بوضوح من دون الضغط على العميل لتكرار الطلب نفسه مرات متتالية؛ وإن كان التواصل مع جهة الإصدار هو المسار المناسب، وضح أن المتجر لا يستطيع تغيير قرارها، مع إبقاء بيانات الطلب غير الحساسة متاحة للدعم
لا تَعِد بأن وسيلة أخرى ستنجح، ولا بأن المشكلة ستختفي بعد عدد ثابت من الدقائق؛ اختلاف البطاقات والجهات والحدود والإعدادات يجعل هذا الوعد غير قابل للتعميم، كما أن كثرة المحاولات ليست استراتيجية تشخيص وقد تزيد الالتباس أو القيود
المصادقة الإضافية: لا تفترض أن العميل أخطأ في الرمز
عندما يتعثر مسار المصادقة، قد يكون السبب انتهاء جلسة أو مشكلة اتصال أو عدم إتاحة الخدمة أو رفضًا من جهة الإصدار؛ لذلك فإن عبارة «رمز التحقق غير صحيح» لا تصلح مظلة لجميع حالات 3D Secure، حتى لو كان الرمز أحد عناصر تجربة العميل
تُظهر قائمة أخطاء المصادقة لدى ميسر وجود أسباب تقنية وأسباب مرتبطة بالجلسة وأخرى مرتبطة بالرفض؛ استخدم هذا التنوع لتصميم خريطة حالات واضحة، لا لنسخ كل التفاصيل إلى شاشة المشتري
إذا انتهت الجلسة فعلًا، يمكن توضيح أن خطوة التحقق لم تكتمل وأن البدء من جديد يكون بعد التحقق من حالة محاولة الدفع السابقة؛ أما إذا ألغى المستخدم المسار، فلا تصف الإلغاء باعتباره عطلًا من البنك، ولا تعرض رسالة نجاح لمجرد عودته إلى المتجر
اختبر العودة من تطبيق البنك أو صفحة المصادقة على الهاتف، وكذلك الرجوع للخلف وإغلاق النافذة؛ هذه الحالات تكشف فجوات لا تظهر عندما يسير المختبر في المسار المثالي فقط، وقد يبقى زر الدفع معطلًا أو تظهر رسالة قديمة بعد تغير الحالة
الاتصال المقطوع: امنع المحاولة العمياء
الرسالة التقنية التي تفيد انتهاء مهلة الطلب لا تحمل وحدها إجابة عن نتيجة الدفع؛ يجب أن يحدد التطبيق هل أُرسل الطلب أصلًا، وهل توجد هوية موثوقة للمحاولة، وكيف يستعلم عن نتيجتها، ومتى يعرض خيار إعادة المحاولة بأمان
منع التكرار ليس إضافة عبارة «اضغط مرة واحدة» أسفل الزر؛ تعطيل الزر يقلل النقرات المتتالية، لكنه لا يمنع إعادة إرسال الطلب من طبقة أخرى أو بعد إعادة تحميل الصفحة، لذلك يلزم تصميم تقني يطابق آلية المزود ويحتفظ بهوية العملية المطلوبة
مفتاح منع التكرار ينبغي أن يمثل العملية نفسها ضمن القواعد التي يحددها المزود؛ لا تفترض أن إعادة استخدامه مع مبلغ مختلف أو سلة جديدة سلوك صحيح، ولا تنسخ اسم الحقل أو مدة صلاحيته من مزود إلى آخر دون مراجعة وثائقه
عندما تتحقق من نتيجة غير محسومة، اعرض مسار متابعة واقعيًا: حالة طلب يمكن تحديثها أو رقم مرجع يتعرف عليه الدعم أو إشعار وفق الإمكانات الفعلية؛ لا تجعل العميل يعيد إدخال بيانات حساسة في قناة دعم لمجرد أن صفحة التأكيد لم تظهر
جدول عملي لربط النص بالحالة المؤكدة
الجدول التالي نقطة انطلاق للتحرير والاختبار، وليس قاموسًا جاهزًا ينسخ إلى كل متجر؛ يراجع المطور ومزود الدفع شروط كل صف قبل تفعيله، ويظل السجل الداخلي أكثر تفصيلًا من الرسالة العامة دون أن يحتوي بيانات حساسة غير لازمة
| الحالة المثبتة | صياغة مقترحة للمشتري | الإجراء | فحص المتجر |
|---|---|---|---|
| تاريخ انتهاء غير مقبول | راجع تاريخ انتهاء البطاقة | تصحيح الحقل | تنسيق الشهر والسنة والتحقق من القيمة |
| رفض جهة الإصدار | لم توافق جهة إصدار البطاقة على العملية | بديل مناسب أو مراجعة الجهة | الحالة النهائية والتفسير المسموح بعرضه |
| جلسة مصادقة منتهية | انتهت جلسة التحقق قبل اكتمالها | اتباع المسار المتاح بعد حسم المحاولة | نتيجة الدفع قبل بدء جلسة أخرى |
| نتيجة لم تُحسم بعد | نتحقق من حالة الدفع، لا تبدأ محاولة جديدة الآن | متابعة الحالة المتاحة | استعلام فعلي وربط المحاولة بالطلب |
| عطل إعداد أو تكامل | تعذر إكمال الدفع حاليًا | مسار بديل إن كان متاحًا | السجلات والإعدادات وتنبيه الفريق المسؤول |
ابنِ سجل حالات بدل تعديل الرسائل داخل الكود عشوائيًا
عندما يكتب كل مطور رسالة في موضع مختلف، يصعب معرفة أين تظهر العبارة القديمة ولماذا؛ الأفضل الاحتفاظ بسجل تحرير للحالات يربط معرفًا داخليًا ثابتًا بالنص العربي وشرط ظهوره والإجراء المتاح ومالك القرار، ثم تنفذ الواجهة هذا الربط بدل اختراع الصياغة أثناء معالجة الخطأ
لا تجعل النص نفسه مفتاحًا في التقارير؛ تغيير «تعذر الدفع» إلى «لم تكتمل العملية» يجب ألا ينشئ فئة قياس جديدة إذا بقي المعنى التقني واحدًا، ولهذا يفيد معرف حالة مستقر ومعه رقم نسخة الرسالة، بينما تبقى التفاصيل الحساسة خارج بيانات التحليل العامة
حدد كذلك أولوية الحالات عند وصول أكثر من إشارة؛ إذا وصل تأكيد نهائي موثوق بعد ظهور تنبيه اتصال سابق، فلا تبقِ رسالة الفشل القديمة فوق حالة النجاح، ولا تعتمد قاعدة زمنية مبسطة تفترض أن آخر حدث وصل هو دائمًا الأصح؛ المرجع هو منطق الحالة المعتمد لدى مزود الدفع والتكامل
للمتجر متعدد اللغات، يحتفظ السجل بمعنى واحد يمكن ترجمته طبيعيًا، لا بترجمة حرفية تفرض ترتيب الكلمات الإنجليزية على العربية؛ يراجع مسؤول المحتوى الصياغة ويؤكد المطور شرط ظهورها، ويعتمد فريق الدعم مسار المتابعة الذي يستطيع تنفيذه فعلًا خلال ساعات الخدمة المعلنة
الدعم الآمن: اجمع مرجعًا تشغيليًا لا بيانات البطاقة
تحتاج تذكرة الدعم إلى معلومات تساعد في العثور على المشكلة: مرجع الطلب أو المحاولة الذي يسمح النظام بمشاركته، وقت تقريبي مع المنطقة الزمنية، نوع الجهاز أو المتصفح عند الحاجة، ووصف ما شاهده العميل؛ لا تبدأ بطلب صورة كاملة من البطاقة أو كشف الحساب أو رمز التحقق
حتى لقطة الشاشة قد تحمل اسمًا أو عنوانًا أو معلومات مالية، لذلك وضح ما يجب إخفاؤه قبل الإرسال إذا كانت الصورة ضرورية؛ وفي كثير من الحالات يكفي نص الرسالة ومرجع الطلب، ما يقلل تداول بيانات لا يحتاجها الفريق أصلًا ويجعل البلاغ أسرع في المعالجة
ضع مسار تصعيد مختلفًا لكل نوع من التعثر؛ مشكلة حقل متكررة بعد تحديث الواجهة تذهب إلى فريق التطوير، ورفض نهائي محدد لا يُعالج بإعادة تشغيل إضافة المتجر، وعدم تطابق حالة الطلب مع مزود الدفع يحتاج فحص التكامل لا مطالبة العميل بالضغط مرة أخرى
لا يعد موظف الدعم برد المبلغ أو بزمن ظهوره لمجرد وجود إشعار مصرفي لدى المشتري؛ يلزم أولًا فهم نوع الحالة والمرجع المتاح وسياسة المزود، ويمكنه تأكيد استلام البلاغ وإجراءات التحقق من دون اتخاذ استنتاج مالي لا يملكه أو نسب الخطأ إلى طرف بعينه
في سجل البلاغ، افصل كلام العميل عن نتيجة الفحص؛ «قال العميل إن التطبيق أظهر خصمًا» ملاحظة، و«حالة العملية لدى المزود كذا» نتيجة قراءة، و«نحتاج مراجعة إضافية» خطوة تالية؛ هذا الفصل يمنع تحول تفسير أولي إلى حقيقة تتناقلها فرق المتجر
أين تظهر رسائل الخطأ العربية في الدفع؟
قد تكون الصياغة جيدة ومع ذلك تفشل التجربة لأن الرسالة أعلى الصفحة بينما الحقل أسفل الشاشة، أو لأن لوحة مفاتيح الهاتف تحجبها، أو لأنها تختفي بعد ثوانٍ قبل أن يقرأها المستخدم؛ راجع التوقيت والموضع وعلاقة الرسالة بالفعل الذي استدعاها، لا الكلمات وحدها
إذا كانت المشكلة مرتبطة بحقل واحد، يحتاج المستخدم إلى معرفة موضعه والوصول إليه دون فقد بقية البيانات غير الحساسة؛ أما المشكلة العامة فتحتاج مكانًا واضحًا في سياق الإرسال، مع تجنب نقل التركيز بصورة مفاجئة أثناء كتابة المستخدم أو فتح حوار لا يستطيع إغلاقه بلوحة المفاتيح
لا تستخدم الإشعار المؤقت وحده لنتيجة تحتاج قرارًا؛ فالمشتري الذي ينتقل إلى تطبيق البنك ثم يعود قد يفوته التنبيه، ولذلك ينبغي أن تبقى حالة المحاولة مرئية أو قابلة للاسترجاع وفق تصميم التطبيق، لا أن تعتمد على ذاكرته لنص اختفى
راجع أيضًا حالة الزر بعد كل مسار؛ الزر المعطل بلا شرح يبدو عطلًا، والزر النشط أثناء تحقق غير محسوم قد يدعو إلى تكرار التنفيذ؛ اربط السلوك بالنظام الفعلي، ولا تَعِد في النص بإجراء لا يظهر زرّه أو لا يعمل بعد انتهاء جلسة الدفع
العربية والاتجاه RTL: اختبر المعنى أثناء الاستخدام
التعريب ليس قلب ترتيب العناصر فقط؛ قد تحتوي الرسالة على مرجع لاتيني أو اسم منتج أو رقم ذي اتجاه مختلف، فيتغير ترتيب المقاطع بصريًا ويصعب نسخ المرجع الصحيح؛ اختبر المزيج على الأجهزة المستخدمة، واعزل المقاطع عند الحاجة وفق تنفيذ الواجهة بدل إضافة مسافات عشوائية إلى النص
تأكد من أن عناوين الحقول واضحة قبل الإدخال وبعد ظهور الخطأ؛ الاعتماد على نص مؤقت داخل الحقل قد يجعل التسمية تختفي عندما يبدأ العميل الكتابة، ثم لا يبقى ما يربط الرسالة بالبيان المطلوب، خصوصًا عند تكبير النص أو استخدام قارئ شاشة
عند قراءة الواجهة آليًا، يجب أن تكون الرسالة مرتبطة بالحقل أو الحالة بصورة يفهمها المستخدم، لا مجرد عنصر أحمر في الشجرة؛ اختبار ذلك يتطلب تفاعلًا فعليًا بأداة مناسبة، ولا يثبت اجتيازه بمجرد وجود خصائص وصول في HTML أو نجاح فاحص آلي
اختبر أرقامًا طويلة، ورسائل تتوزع على أكثر من سطر، وزيادة حجم النص، والوضع الأفقي للهاتف؛ لا تختصر العبارة إلى كلمة مبهمة لإجبارها على سطر واحد، بل عدل المساحة والتخطيط مع بقاء الإجراء مفهومًا ومقروءًا دون تمرير أفقي غير ضروري
إذا كان الجمهور يضم مستخدمين غير تقنيين، استخدم تعبيرًا عربيًا مباشرًا مع تجنب المصطلحات المتراكمة؛ يمكن إبقاء اسم 3D Secure في شرح مساعد عند الحاجة، لكن ليس من الضروري أن يعرف المشتري أسماء الخوادم والبروتوكولات لكي يفهم أن خطوة التحقق لم تكتمل
اختبر الحالات في بيئة مناسبة قبل إطلاق الرسائل
ابدأ ببيئة الاختبار التي يوفرها مزود الدفع وبطاقات الاختبار المعلنة لديه؛ لا تختبر أعطال الواجهة على العملاء الحقيقيين ولا تفترض أن بطاقة الاختبار تصلح في بيئة الإنتاج، وتأكد أن مفاتيح البيئة والروابط والإشعارات لا تختلط أثناء التجربة
أنشئ حالة اختبار لكل انتقال مهم: رفض إدخال قبل الإرسال، رفض نهائي بعد الإرسال، بدء المصادقة والعودة منها، انتهاء الجلسة، قطع الاتصال بعد الطلب، ثم وصول نتيجة متأخرة؛ المطلوب ليس تكرار شاشة واحدة بل التأكد من أن الرسالة والسلوك يتغيران مع الحالة الصحيحة
لكل تجربة سجل النتيجة المتوقعة والنتيجة التي ظهرت فعلًا ومعرف الحالة الداخلي، ثم افحص حالة الطلب لدى المزود والمتجر؛ نجاح ظهور النص لا يكفي إذا بقي الطلب معلقًا بلا متابعة، كما أن ظهور صفحة التأكيد لا يعوض خطأ في ربط العملية بالطلب
اختبر العودة إلى السلة وتعديل الكمية أو الشحن بعد محاولة لم تكتمل؛ هذه التغييرات قد تنشئ طلبًا مختلفًا أو مبلغًا مختلفًا، ولذلك يجب أن يراجع المطور هوية المحاولة ومفتاح منع التكرار وفق القواعد المعتمدة، لا أن يعيد استخدامهما آليًا لأن المستخدم هو نفسه
لا تجعل اختبار الرسائل سببًا لتغيير إعدادات المدفوعات أو تعطيل ضوابط الحماية على الموقع كله؛ إذا ظهر عيب محدد، عالجه ضمن نطاقه مع نسخة احتياطية وخطة رجوع، ثم أعد الحالة المتأثرة والاختبارات المجاورة بدل إقرار سلامة جميع المسارات من تجربة واحدة ناجحة
هل تكفي ترجمة رموز البوابة إلى العربية؟
لا، لأن رمز الاستجابة وحالة الدفع والخطأ الذي تراه الواجهة ليست شيئًا واحدًا؛ توضح وثائق رموز الاستجابة لدى ميسر أن توفر رمز البوابة مرتبط بمرور العملية عبر مسار محدد، ولذلك لا يجوز تحويل غيابه وحده إلى تشخيص مثل رفض البنك
التنفيذ الجيد يحتفظ بالرمز في موضعه التشغيلي المسموح، ثم يختار فئة تحريرية مناسبة بناء على الحالة وبقية الإشارات؛ قد تتشارك رموز متعددة رسالة عامة واحدة عندما لا تكون التفاصيل مفيدة أو مسموحة للمشتري، بينما يظل الدعم قادرًا على التمييز داخليًا وفق صلاحياته
كذلك لا تنقل خريطة مزود إلى مزود آخر لمجرد تشابه أسماء الحالات؛ تختلف الحقول والتفسيرات ومسارات المصادقة وآليات الاستعلام، وتصبح الترجمة المجمعة مصدر أخطاء إذا تجاهلت هذه الفروق، خصوصًا عند تغيير بوابة أو إضافة وسيلة دفع جديدة إلى متجر قائم
قس أثر التحسين دون عدّ كل محاولة بيعًا ضائعًا
عدد رسائل الخطأ لا يساوي عدد المشترين الذين خسرهم المتجر؛ قد يواجه الشخص نفسه خطأ إدخال ثم يصححه وينجح، وقد تتكرر أحداث تقنية للمحاولة نفسها، وقد يغادر العميل لسبب آخر؛ لذلك افصل الجلسة والمحاولة والطلب والعملية المدفوعة عند قراءة التقرير
ابدأ بسؤال محدد مثل: هل صار العميل الذي يواجه خطأ تاريخ الانتهاء قادرًا على تصحيحه؟ يحتاج هذا إلى تعريف واضح للحالة وبداية القياس ونهايته، ثم مقارنة مناسبة تراعي تغير الأجهزة والوسائل والعروض؛ لا تنسب كل تغير في المبيعات إلى تعديل الرسالة وحده
استخدم فئات خطأ عامة ومعرفات تشغيلية مضبوطة بدل إرسال النص الكامل القادم من المزود إلى أدوات التحليل؛ النص قد يتغير أو يحمل تفاصيل لا ينبغي جمعها، كما أن أسماء الأحداث المبالغ في تنوعها تجعل المقارنة أصعب وتخلط بين تغييرات الصياغة وتغييرات الحالة
المؤشر المفيد قد يكون انخفاض تذاكر الاستفسار المتكرر عن معنى رسالة بعينها، أو تحسن إكمال تصحيح الحقل في اختبار مضبوط؛ لكنه لا يصبح دليلًا على زيادة الإيراد دون ربط صحيح بالطلبات المدفوعة، ولا على رضا العملاء دون قياس يناسب هذا الاستنتاج
ولمن يحتاج فصل القياس عن الحالة التجارية، يتناول دليل مطابقة بيانات القياس والطلبات زاوية مختلفة هي مطابقة القياس بالطلبات بعد الإلغاء والاسترجاع؛ أما هذا المقال فمحوره الرسالة التي يراها المشتري والخطوة الآمنة بعدها، لا بناء نظام إسناد مبيعات
مثال تطبيقي: إعادة صياغة رسالة عامة دون وعد زائف
افترض متجرًا يعرض «حدث خطأ، حاول مجددًا» لكل الحالات؛ لا تبدأ بكتابة عشر جمل أجمل، بل راجع الحالات التي يستطيع التكامل تمييزها فعلًا؛ إذا لم يستطع حسم نتيجة الاتصال، فهذه فجوة تقنية يجب علاجها قبل أن تكتب رسالة تؤكد فشل العملية أو عدم الخصم
بعد تحديد الحالات، يمكن بناء نسخة أولية تفصل خطأ الحقل عن الرفض النهائي عن التحقق الجاري؛ يراجع الدعم ما إذا كان يستطيع متابعة المرجع المعروض، ويختبر المطور انتقالات الحالة، ثم يراجع محرر عربي الوضوح واتساق الأفعال والضمائر من دون إضافة أسباب لا يعيدها النظام
عند الإطلاق، راقب الحالة التي تغيرت وحدها وسجل نسخة النص ووقت التفعيل؛ إذا ظهرت تذاكر جديدة لأن «التحقق الجاري» يستمر بلا نهاية، فالحل ليس استبدال العبارة بكلمة أكثر طمأنة، بل إصلاح المتابعة ووضع مسار واضح للحالات التي لا تُحسم تلقائيًا
أسئلة شائعة عن رسائل أخطاء الدفع
هل أكتب أن المبلغ لم يُخصم عند ظهور خطأ اتصال؟
لا تكتب ذلك اعتمادًا على خطأ الاتصال وحده؛ يلزم تحقق موثوق من حالة العملية وما تسمح الحالة بتأكيده، وإلا استخدم رسالة تعكس عدم حسم النتيجة مع مسار متابعة حقيقي
هل تعثر المصادقة يعني أن رمز التحقق خطأ؟
ليس بالضرورة؛ قد تتعلق المشكلة بالجلسة أو الاتصال أو عدم إتاحة الخدمة أو رفض المصادقة، لذلك اربط النص بالسبب المؤكد بدل اتهام المستخدم بخطأ في الرمز في كل الحالات
هل أعرض رمز البوابة كاملًا للمشتري؟
الأفضل تقديم شرح مفهوم وخطوة مناسبة؛ يمكن إبقاء مرجع دعم غير حساس إذا كان مفيدًا، بينما تحفظ التفاصيل التقنية المسموح بها في السجل التشغيلي ولا تعرض بيانات أمنية أو استنتاجات غير لازمة
هل تكرار الضغط على زر الدفع يعالج المشكلة؟
ليس إجراء تشخيص موثوقًا؛ ينبغي حسم حالة المحاولة السابقة وتطبيق قواعد مزود الدفع لمنع التكرار قبل السماح بمحاولة أخرى، خصوصًا بعد انقطاع الاتصال أو غياب التأكيد
ما المعلومات المناسبة لإرسال بلاغ دعم؟
مرجع الطلب أو المحاولة المسموح بمشاركته ووقت المشكلة ونص الرسالة ووصف الجهاز عند الحاجة؛ لا ترسل رقم البطاقة الكامل أو رمز الأمان أو رمز التحقق في محادثة الدعم
هل اللون الأحمر وحده يكفي لتوضيح الخطأ؟
لا يكفي لتقديم وصف نصي مفهوم؛ حدد الحقل أو الحالة وبيّن المشكلة، ثم اختبر ارتباط الرسالة وسلوكها مع لوحة المفاتيح وقارئ الشاشة بدل الاكتفاء بالشكل البصري
هل يمكن استخدام الصياغات نفسها مع كل بوابة؟
يمكن مشاركة مبادئ الوضوح والحذر، لكن ربط الرسائل بالحالات والرموز وإعادة المحاولة يجب أن يراجع لكل مزود وتكامل؛ تشابه المصطلحات لا يثبت تطابق السلوك
مصادر ومراجع التنفيذ
تستند الفروق التقنية في هذا الدليل إلى وثائق ميسر لأخطاء الدفع والاستجابة والمصادقة ومنع التكرار المرتبطة داخل الشرح، وإلى إرشادات W3C لتحديد الخطأ واقتراح التصحيح؛ أما الأمثلة العربية وسير التشخيص فهي توصيات تحريرية تطبيقية تحتاج اختبارًا في المتجر الفعلي قبل استخدامها
رسائل الخطأ العربية في الدفع لا تَعِد بنجاح العملية ولا تختلق سبب الرفض؛ وظيفتها أن تنقل ما ثبت وتمنع التصرف الخاطئ وتفتح الطريق المناسب للمشتري أو الدعم، وتظل جودة التكامل شرطًا لصدقها مهما كانت صياغتها متقنة
إذا كان التعثر جزءًا من رحلة أوسع، فاقرأ دليل تحسين مسار الدفع والسلات المتروكة باعتباره موضوعًا مكملًا لا بديلًا عن تشخيص الرسائل؛ وعندما تكون المشكلة في تصميم التكامل نفسه، يوضح دليل تطوير المواقع المخصصة وبوابات الدفع إطارًا أوسع لمناقشة المتطلبات مع فريق التنفيذ
قبل تسليم النسخة الجديدة، اتفقوا على شخص يملك مراجعة الرسالة عند تغير المزود أو إضافة وسيلة دفع؛ النص الذي كان صحيحًا في تكامل سابق قد يصبح مضللًا بعد التحديث، ولهذا يحتاج سجل الحالات إلى تاريخ تغيير حقيقي وسبب واضح، لا عبارة مراجعة شكلية لا ترتبط باختبار
اجعل رسالة الدفع جزءًا من تجربة شراء واضحة
إذا كان متجرك يجمع حالات مختلفة تحت تنبيه واحد، ابدأ بمراجعة تربط النص بسلوك الواجهة ونتيجة العملية قبل التفكير في تغيير الألوان أو زيادة الإلحاح على زر الدفع


