انتقل إلى المحتوى
كل المقالات
الرعاية-الصحيةالسعوديةتطبيقات-الجوالالمدفوعاتدراسة-حالة

تطبيق بطاقة خصم طبي في السعودية: ما بنيناه لتكافل الذهبية

١٢ نوفمبر ٢٠٢٦ 9 دقيقة قراءة· Mahmoud Makhlouf
Read this article in English

مشترك يقف عند استقبال مستوصف في جدة، يمدّ بطاقة الخصم البلاستيكية، فتسأله الموظفة: "البطاقة سارية؟". لا أحد عند الكاونتر يملك الجواب، فيبدأ اتصال بخدمة العملاء والمريض ينتظر.

الإجابة المختصرة: تطبيق بطاقة الخصم الطبي ينقل ثلاثة أشياء إلى جوال المشترك: البطاقة نفسها برمز QR، وشبكة المراكز مرتبة حسب الأقرب، وشراء الخدمات الطبية مقدماً. المشترك يطلب بطاقته ويضيف أفراد أسرته ويدفع من التطبيق، ثم يشتري عروض العيادات بعد التحقق من هويته، ويقسّط بتابي، وتُحسب الضريبة حسب جنسيته.

المشكلة التجارية

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

أين تظهر الخسارة؟

  • عند الاستقبال. الموظف لا يستطيع التأكد من سريان العضوية، فيتردد في تطبيق الخصم. والبطاقة التي لا تثق بها العيادة لا يجددها صاحبها.
  • في البحث عن مركز. القوائم المطبوعة تتقادم بسرعة. المشترك لا يعرف أي مركز قريب منه داخل الشبكة، فلا يستخدم البطاقة أصلاً.
  • في الإيراد. البطاقة تُباع مرة في السنة، وكل ما يحدث بين تجديد وآخر، من كشف وتحاليل وأسنان، يتم في العيادة دون أن تكسب منه شركة البطاقة شيئاً.

تكافل الذهبية مثال واضح على هذا النوع من المشاريع. التطبيق يعرّف المنتج بصدق: بطاقة تكافل للخصومات الطبية، ليست تأميناً صحياً، متاحة للمواطنين والمقيمين والزوار، والخصم يختلف من مركز لآخر. المطلوب كان أن يصبح هذا الوعد قابلاً للاستخدام من الجوال.

ما الخيارات المتاحة لك؟

الخيارماذا تحصل عليهالمقابل
تبقى البطاقة البلاستيكية مع دليل مراكز على الموقعأقل تكلفة للبدءلا تحقق من السريان عند الاستقبال، والدليل يتقادم
تطبيق عضوية جاهز بعلامتكإطلاق سريع وشاشات معتادةصعب أن يناسب باقاتك وبطاقات الأسرة وجودة العربية وطرق الدفع المحلية
تطبيق مخصص على نظامكبطاقة وشبكة ومسار طلب مصممة حول نشاطكاستثمار أولي أعلى، وتحتاج فريقاً يحافظ على الجودة سنوات
تطبيق مخصص مع متجر عروض العياداتإيراد بين التجديداتيضيف الدفع والتحقق من الهوية وقواعد الضريبة وخطاب للعيادة

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

كيف بنينا تكافل الذهبية

تطبيق تكافل الذهبية مبني بـFlutter على iOS وAndroid، عربي أولاً مع نسخة إنجليزية كاملة، ويعمل فوق واجهة Laravel الخاصة بالعميل. فريقنا يطوّره ويصونه، ويدور التطبيق حول أربع مهام.

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

ثانياً: بيع البطاقة دون مركز اتصال. يختار المشترك الباقة، ويعبّئ بيانات صاحب البطاقة الرئيسية، ثم بيانات البطاقات الإضافية التي تشملها الباقة، اسم ورقم هوية لكل فرد. بعدها يدفع أونلاين عبر صفحة PayTabs داخل WebView، أو يختار الدفع عند الاستلام. وبعد الدفع الإلكتروني يطلب التطبيق من الخادم تأكيد النتيجة، ولا يكتفي بصفحة التحويل.

ثالثاً: بطاقة يصدّقها موظف الاستقبال. البطاقة الرقمية تحمل رمز QR، ويمكن تصديرها شهادة PDF قابلة للطباعة. وعلى الشاشة تتصرف كبطاقة حقيقية: تدخل بحركة طيران، وتميل مع الإصبع أو مع حركة الجوال عبر حساس الحركة، ويلمع سطحها مع الضوء، وتنقلب عند اللمس لتظهر ظهرها. هذه هي اللحظة التي يمدّ فيها المشترك جواله عبر الكاونتر، فلا بد أن تبدو البطاقة رسمية. ومن فعّل خيار تقليل الحركة في جواله تتوقف عنده الإمالة واللمعان، ويصبح القلب فورياً.

البطاقة المتحركة وهي تدخل وتميل ثم تنقلب لتظهر رمز QR على الظهرالبطاقة المتحركة وهي تدخل وتميل ثم تنقلب لتظهر رمز QR على الظهر

رابعاً: أقرب عيادة، ثم الشراء منها. قائمة الشبكة تعرض المسافة إلى كل مركز وترتبها من الأقرب. ووحدة المتجر تتيح لحامل البطاقة شراء عروض العيادات مقدماً، والدفع بتابي، واستلام خطاب تعميد يقدّمه للعيادة.

بنينا المنظومة كاملة وراء هذه الشاشات ونشغّلها: تطبيق Flutter للأعضاء، والخادم المبني بـLaravel وMySQL الذي يُصدر البطاقات ويدير الشبكة الطبية والعروض ويعالج المدفوعات.

من الداخل: مسافة صادقة

عرض المسافة إلى كل عيادة يبدو أمراً بسيطاً، لكن احتمالات الخطأ فيه كثيرة.

check permission ──► denied forever? ──► "open settings" button, no prompt loop
        │
        ▼ granted
last known fix (instant) ──► show distances now
        │
        ▼
fresh fix, medium accuracy, 8 s limit ──► update only if moved > 50 m
        │
        ▼ timeout / error
keep last position, never show an error

ثلاث حالات حددت شكل الكود:

  • رفض دائم للإذن. في Android، فحص الإذن العادي لا يخبرك أبداً أن المستخدم رفض "نهائياً"؛ طلب الإذن وحده يخبرك. لو لم يتذكر التطبيق ذلك لعامل المستخدم الرافض كأنه لم يُسأل بعد، في كل تشغيل. لذلك نحفظ هذه الحالة، وفي iOS نعامل الرفض الذي يستمر بعد الطلب كرفض دائم. والمستخدم يجد زراً يفتح الإعدادات الصحيحة: إعدادات التطبيق عند رفض الإذن، وإعدادات الموقع حين يكون GPS مطفأ.
  • موقع لا يصل. يعرض التطبيق آخر موقع معروف فوراً، ثم يطلب موقعاً جديداً بحد أقصى ثماني ثوانٍ. إن انتهت المهلة تبقى المسافات المعروضة كما هي. غياب الموقع حالة طبيعية، لا رسالة خطأ. والتحركات الأقل من 50 متراً تُتجاهل حتى لا تتقافز القائمة بسبب تذبذب GPS.
  • مراكز عند الإحداثيات 0,0. بعض السجلات تصل بإحداثيات 0,0 أو بقيم تالفة، وهذه تضع مركزاً في الرياض وسط خليج غينيا. نرفضها، ونضع تلك المراكز في آخر القائمة مع الحفاظ على ترتيبها الأصلي.
GeoPoint? geoPointFrom(String? lat, String? long) {
  final latitude = parseCoordinate(lat, isLatitude: true);
  final longitude = parseCoordinate(long, isLatitude: false);
  if (latitude == null || longitude == null) return null;
  if (latitude == 0 && longitude == 0) return null; // placeholder, not a place
  return GeoPoint(latitude, longitude);
}

بيانات المراكز تُخزّن على الجهاز في Hive بصلاحية 24 ساعة في نسخة الإنتاج، ومعها فهرس بحث جاهز، فيعمل البحث دون إنترنت. ونص البحث يُوحَّد عربياً: تُحذف الحركات والتطويل، وتُرد أشكال الهمزة إلى ألف، والتاء المربوطة إلى هاء، فيجد المستخدم المركز مهما كتب اسمه. والاستيراد يجري في Isolate منفصل حتى لا تتجمد الواجهة.

قائمة الشبكة الطبية بالعربية مع المسافة بالكيلومتر والأقرب أولاًقائمة الشبكة الطبية بالعربية مع المسافة بالكيلومتر والأقرب أولاً

من الداخل: متجر يبيع خدمات العيادات

المتجر هو مصدر الإيراد بين التجديدات، وفيه أغلب القواعد.

مركز واحد في السلة. السلة تحمل خدمات مركز واحد فقط. وإذا أضاف المستخدم عرضاً من مركز آخر يسأله التطبيق إن كان يريد استبدال السلة. بهذا يبقى كل طلب لمقدم خدمة واحد وخطاب تعميد واحد.

الهوية قبل الدفع. الدفع يطلب ثلاث خطوات بالترتيب: رقم الهوية، ثم الجنسية، ثم رمز تحقق يُرسل برسالة نصية إلى الجوال المسجل على بطاقة تكافل، ويظهر الرقم مخفياً جزئياً. الخادم يتأكد أن صاحب الهوية يحمل بطاقة سارية قبل إرسال الرمز. بعدها فقط يفحص التطبيق أهلية تابي ويفعّل زر الدفع.

الضريبة حسب الجنسية. لهذا وُجدت خطوة الجنسية. بموجب الأمر الملكي رقم أ/86 لعام 2018 تتحمل الدولة ضريبة القيمة المضافة عن المواطنين السعوديين في الخدمات الصحية الخاصة. ودليل هيئة الزكاة والضريبة والجمارك للقطاع الصحي (الإصدار الثاني، مايو 2026، وقت كتابة هذا المقال) يوضح أن المنشأة تصدر للمواطن فاتورة دون ضريبة بعد التحقق من هويته وتسجيل رقمها، بينما تُفرض النسبة الأساسية 15% على غير السعوديين. ويذكر الدليل أن الحكم لا يشمل مواطني دول الخليج ولا الزوج أو الزوجة غير السعوديين لمواطن أو مواطنة، ولا أبناء المواطنة من زوج غير سعودي. لاحظ الصياغة: الهيئة لا تسميها "نسبة صفرية"، بل تحمّل الدولة للضريبة. التطبيق يعرض تقديراً فقط، والرقم المعتمد يأتي من الخادم:

/// Client-side preview only; the server's `vat` is authoritative.
double vatRateFor(String? nationality) =>
    nationality == null || nationality == saudiNationality ? 0 : 0.15;

هذه معلومات عامة وليست استشارة ضريبية، فراجع معالجة خدماتك مع مستشارك.

تابي بعد فحص الأهلية. توثيق تابي يوصي بفحص أهلية مسبق في الخلفية قبل عرض خيار الدفع. نجريه بعد التحقق من الهوية، ولا نفعّل زر "ادفع بتابي" إلا إذا كانت النتيجة إيجابية. وإن فشل الفحص لسبب في الشبكة يبقى المستخدم في خطوته مع زر إعادة المحاولة، ولا يعود إلى البداية. ولمن يريد فهم الجانب التجاري للتقسيط كتبنا دليل ربط تمارا وتابي.

خطوات التحقق في صفحة الدفع: رقم الهوية ثم الجنسية ثم رمز SMS ثم تابيخطوات التحقق في صفحة الدفع: رقم الهوية ثم الجنسية ثم رمز SMS ثم تابي

الخادم يقرر نتيجة الدفع. صفحة تابي تعمل داخل WebView، لكن رابط العودة ليس دليلاً على الدفع. لذلك يسأل التطبيق الخادم عن حالة الطلب كل ثلاث ثوانٍ حتى يُدفع أو يفشل أو يُلغى:

Future<void> pollOnce() async {
  final uuid = state.uuid;
  if (uuid == null || state.phase != PaymentPhase.awaiting || _polling) return;
  _polling = true;
  try {
    final order = await _api.fetchOrder(uuid);
    await _apply(order.paymentStatus, order.isPaid, order);
  } catch (error) {
    if (error is ApiFailure && error.statusCode == 401) {
      _timer?.cancel();
      emit(PaymentState(phase: PaymentPhase.reauth, uuid: state.uuid));
    } // anything else: the next tick asks again
  } finally {
    _polling = false;
  }
}

يتوقف السؤال حين ينتقل التطبيق إلى الخلفية، ويعود مع فحص فوري عند الرجوع. وإن انتهت جلسة المتجر أثناء الدفع (401) يُطلب من المستخدم التحقق من جديد بدل مؤشر انتظار لا ينتهي. وعند الدفع تُفرّغ السلة، لكن فقط إذا كانت العناصر المدفوعة هي عناصر السلة نفسها، فدفع طلب قديم من "طلباتي" لا يمسح سلة جديدة. ثم يستلم المشترك خطاب التعميد.

جودة العربية تحرسها الاختبارات

التطبيق العربي يتراجع بصمت: نص مكتوب مباشرة في الكود، أو مفتاح ترجمة موجود بالإنجليزية وناقص بالعربية، أو شاشة في الوضع الداكن ببطاقات بيضاء. في المشروع 72 ملف اختبار، وبعضها موجود لهذا الغرض تحديداً:

  • اختبار تطابق اللغتين يفشل إذا اختلفت المفاتيح بين العربية والإنجليزية، أو كانت أي ترجمة فارغة.
  • اختبار منع النصوص العربية المكتوبة في الكود يفحص مجلد lib ويفشل عند أي نص عربي خارج قائمة استثناءات محددة، مثل الشهادة المطبوعة العربية بطبيعتها.
  • اختبار مراجعة الصياغة يمنع عودة عبارات قديمة غامضة.
  • اختبار ألوان الأسطح يفشل إذا استخدمت شاشات محددة ألواناً ثابتة بدل رموز الوضع الداكن في نظام التصميم.

والتحديثات تُدار بالانضباط نفسه: Firebase Remote Config يحمل حداً أدنى إلزامياً وآخر موصى به لكل منصة، والتطبيق يذكّر بالإصدارات الجديدة في المتجر مرة واحدة يومياً على الأكثر، وفي Android يستخدم التحديث المرن داخل التطبيق من Google Play الذي ينزّل في الخلفية ويثبّت عند إعادة التشغيل. وإن كانت واجهتك العربية تعاني، فمقالنا عن أخطاء تصميم المنتجات العربية يشرح ما تحميه هذه الاختبارات.

قائمة تحقق قبل بناء تطبيق بطاقة خصم أو عضوية

  1. حدد ما يراه موظف الاستقبال. شاشة البطاقة هي المنتج، فاجعلها أقصر مسار في التطبيق ومعها رمز تتحقق منه العيادة.
  2. صمّم بطاقات الأسرة من اليوم الأول: من يدفع، وهوية من على كل بطاقة، ومن ينتقل بين الحسابات على جوال واحد.
  3. اعتبر الموقع اختيارياً، وتعامل مع الرفض والرفض الدائم وإطفاء GPS وانتهاء المهلة دون رسائل خطأ.
  4. افحص إحداثيات المراكز وارفض 0,0 والقيم الخارجة عن النطاق قبل حساب المسافة.
  5. خزّن الشبكة على الجهاز بمدة صلاحية، ووحّد نص البحث العربي.
  6. إن كنت تبيع خدمات، فتحقق من الهوية قبل الدفع واربطها بالجوال المسجل على البطاقة.
  7. اجعل الخادم صاحب القرار في نتيجة الدفع، وتعامل مع انتهاء الجلسة.
  8. احسب الضريبة لكل مشترٍ على حدة، وراجع دليل الهيئة الحالي مع مستشارك.
  9. ضع اختبارات تطابق الترجمة ومنع النصوص الثابتة في مجموعة الاختبارات، لا في قائمة مراجعة يدوية.

الأسئلة الشائعة

ما هو تطبيق بطاقة الخصم الطبي؟

هو تطبيق جوال يحل محل بطاقة الخصم البلاستيكية. المشترك يعرض بطاقة رقمية برمز QR في المراكز المشاركة، ويتصفح الشبكة التي تقدم الخصم. وهو ليس تأميناً صحياً؛ المشترك يدفع للمركز مباشرة بالسعر المخفّض.

هل يمكن إضافة أفراد الأسرة إلى الاشتراك نفسه؟

نعم إذا كانت باقاتك تسمح بذلك. في تكافل الذهبية قد تشمل الباقة بطاقات إضافية، ونموذج الطلب يجمع اسم ورقم هوية كل فرد. ويمكن أيضاً حفظ أكثر من حساب على الجوال نفسه للتنقل بينها.

هل يدفع المواطن السعودي ضريبة القيمة المضافة على الخدمات الصحية الخاصة؟

بموجب الأمر الملكي أ/86 تتحمل الدولة الضريبة عن المواطن السعودي في الخدمات الصحية الخاصة، ويصدر له المركز فاتورة دون ضريبة بعد التحقق من هويته. أما غير السعوديين، ومنهم مواطنو دول الخليج، فيدفعون 15%. والسلع المرتبطة كالأدوية والنظارات لها معالجتها الخاصة.

هل أستطيع بيع عروض العيادات بالتقسيط عبر تابي؟

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

ما الفرق بين بطاقة تكافل للخصم الطبي والتأمين الصحي؟

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

الخطوة التالية

إن كانت شركتك تدير شبكة خصومات أو عضوية وما زالت تعتمد على البطاقة البلاستيكية والاتصالات، فابدأ بكتابة باقاتك وقواعد بطاقات الأسرة وكيف تتحقق العيادة من المشترك اليوم. أرسل لنا وصف مشروعك وسنقترح عليك ما يدخل في الإصدار الأول وما يمكن تأجيله.

// لنبدأ

عندك فكرة منتج؟ خذ خطة واضحة و مكالمة تعارف مجانية 15 دقيقة.

احكِ لنا عن مشروعك، ونرجع لك بتصوّر للتنفيذ وجدول زمني مبدئي وتقدير أولي للتكلفة — عادةً خلال 24 ساعة.

احجز مكالمة مجانية WhatsApp