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

ما تطلبه كي نت وTap وماي فاتورة فعليًا

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

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

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

التسلسل الحقيقي والمدة الزمنية

الترتيب غير قابل للتفاوض، لأن كل خطوة مدخل للتي بعدها:

  • السجل التجاري والحساب البنكي المؤسسي — من أسبوع إلى ثلاثة إذا كان السجل نظيفًا. لا شيء يبدأ قبلهما.
  • طلب البوابة وإجراءات اعرف عميلك — من 2 إلى 5 أيام عمل لدى المجمّع، وأطول إذا كان المفوض بالتوقيع خارج البلد.
  • بيانات بيئة الاختبار — عادة في الأسبوع نفسه. ابنِ مسار الدفع كاملًا هنا، بما فيه مسارات الفشل.
  • مراجعة الالتزام للموقع الحي — الخطوة التي تستهلك شهرًا بصمت، لأنها لا تبدأ إلا بعد اكتمال الموقع فعلًا.
  • مفاتيح الإنتاج — من أسبوع إلى ثلاثة بعد نجاح المراجعة لدى المجمّع، ومن 4 إلى 8 أسابيع لمعرّف تاجر مباشر من كي نت.
  • إعداد التسوية — تصل الحوالات بعد يوم إلى ثلاثة أيام عمل إلى الحساب الكويتي، مع فجوات نهاية الأسبوع والأعياد الرسمية.

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

ما الذي يتعطل عندما تتحرك أموال حقيقية

إعادة التوجيه و3DS. كي نت تعمل بصفحة مستضافة وإعادة توجيه، لا بنموذج بطاقة تدمجه داخل تطبيقك. يترك العميل تطبيقك إلى صفحة البنك وعليه أن يعود — لذا يجب أن تعالج الروابط العميقة على iOS وأندرويد، وانتهاء مدة الجلسة، وإغلاق المتصفح في منتصف التحقق. ويضيف 3-D Secure على البطاقات شاشة تحقق ثانية لها نسبة تخلٍّ خاصة بها. اعتبر معاملات العودة مجرد مؤشر: المصدر الوحيد للحقيقة هو نداء تحقق من الخادم مع إشعار البوابة.

الإشعارات المفقودة. تنجح العملية، ولا يصل الإشعار، فتبقى لديك دفعة يتيمة وعميل غاضب. تحتاج مفتاح عدم تكرار لكل طلب، وآلة حالة للدفع يمكن إعادة تشغيلها، ومهمة يومية تسحب قائمة عمليات البوابة وتطابقها مع طلباتك. طابِق بمرجع البوابة، لا برقم طلبك وحده.

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

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

ما نفعله في أي مشروع

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

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