ربط كي نت بالموقع: دليل تقني لبوابة الدفع في الكويت

كيف يعمل ربط كي نت بالموقع؟

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

1. يختار العميل كي نت في صفحة الدفع، فيرسل خادم موقعك طلب دفع يتضمن المبلغ بالدينار ورقم الطلب ورابطين للعودة: رابط للنجاح ورابط للفشل.
2. يعود الرد برابط تحويل، فينتقل متصفح العميل إلى صفحة الدفع التابعة لكي نت.
3. يُدخل العميل بيانات بطاقته ويُكمل الدفع في صفحة كي نت، ولا يمر رقم البطاقة على موقعك إطلاقاً.
4. تعيد كي نت العميل إلى رابط النجاح أو الفشل في موقعك.
5. يتأكد خادمك من الحالة النهائية للعملية، عبر إشعار Webhook أو استعلام مباشر، ثم يُسجَّل الطلب مدفوعاً.

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

وللعملية مهلة محددة. بحسب وثائق Checkout.com، إذا حاول العميل إكمال الدفع بعد أكثر من سبع دقائق من وصوله إلى صفحة كي نت تُلغى العملية تلقائياً ويصلك إشعار payment_expired، وإذا ألغى العميل الدفع يصلك إشعار إلغاء (payment_canceled). لذلك يحتاج نظام الطلبات عندك حالة "بانتظار الدفع" تنتهي تلقائياً وتُرجع المخزون المحجوز.

ما الذي يدعمه الدفع عبر كي نت وما الذي لا يدعمه؟

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

نقطتان يغفل عنهما كثيرون. الأولى أن Checkout.com يطلب منك التواصل مع البنك لتفعيل الاسترجاع قبل أن تتمكن من تنفيذه. والثانية أن KFast لا تحل مشكلة الاشتراكات. KFast خيار الدفع السريع من كي نت: في تكامل Checkout.com ترسل card_token مع طلب الدفع، ويمكن للعميل التسجيل في KFast من صفحة كي نت، ويحتاج التسجيل رمز تحقق يُرسل إلى رقم الهاتف المسجل لدى بنكه. وتصفها Checkout.com بأنها لتسريع الدفع للعميل العائد، لكنها لا تسمح لك بالخصم من دون أن يؤكد العميل الدفع بنفسه.

هل يعمل Apple Pay مع كي نت؟

نعم. تنص وثائق Checkout.com على أن مدفوعات Apple Pay في الكويت يجب أن تمر عبر شبكة كي نت. وتحتاج من البنك المحصّل ثلاث بيانات: Transportal ID وكلمة مرور Transportal ومفتاح التشفير، إضافة إلى شهادة معالجة مدفوعات Apple Pay تُضبط في بوابة كي نت بحسب دليل التاجر الذي تطلبه من كي نت. وتصف Amazon Payment Services هذا المسار بأنه إلزامي لكل مدفوعات Apple Pay في الكويت، وتذكر أنه لا يدعم حجز المبلغ (Authorization) ولا الدفعات المتكررة، أي أن قيود كي نت السابقة تنطبق على Apple Pay أيضاً. خطوات الإعداد للموقع والتطبيق في دليل ربط Apple Pay بالمتجر.

الدينار الكويتي بثلاث خانات عشرية

يحدد معيار ISO 4217 للدينار الكويتي (الرمز KWD والرقم 414) ثلاث خانات عشرية، فالدينار الواحد يساوي 1000 من أصغر وحدة فيه. والكود المكتوب للدولار أو اليورو يفترض عادة خانتين، وهذا الافتراض يكسر مبالغ الدينار.

وبحسب وثائق Checkout.com يُقسم المبلغ المرسل بالدينار على 1000، فالقيمة 12750 تعني 12.750 د.ك. قبل الإطلاق راجع أربعة مواضع: المبلغ المرسل إلى البوابة، والمبلغ المحفوظ في الطلب، والمبلغ المطبوع في الفاتورة والرسائل، وطريقة تقريب الخصومات ورسوم التوصيل. إذا دفع العميل 12.750 د.ك وظهر المبلغ 1.275 د.ك، فأحد هذه المواضع يفترض خانتين.

ما الذي تغيّر في بوابة كي نت في يونيو 2026؟

أعلنت كي نت في مايو 2026 أن صفحة الدفع لن تبدأ بقائمة البنوك اعتباراً من 5 يونيو 2026. وبحسب تقرير Arab Times المنشور في 4 مايو 2026، ذكرت كي نت أن الهدف تقليل البيانات البنكية التي قد تكشفها قائمة البنوك، ومعالجة حالات نادرة تتشابه فيها أرقام بطاقات بنوك مختلفة، ومواكبة التطورات العالمية في الدفع الرقمي، وفتح الباب مستقبلاً لبنوك أجنبية ومحافظ رقمية مرخصة من بنك الكويت المركزي، مع أن المسؤولين أشاروا إلى عدم وجود جدول زمني محدد لذلك.

ووصف تقرير Kuwait Times المنشور في 6 يونيو 2026 الصفحة الجديدة: يكتب العميل أول أرقام بطاقته، فتظهر قائمة بالبطاقات المطابقة مع شعارات البنوك، وتضيق القائمة كلما أضاف أرقاماً، ثم يختار بطاقته ويكمل باقي الرقم ويُدخل تاريخ الانتهاء.

لم يذكر أي من التقريرين تغييراً في طريقة ربط التجار. لكن التغيير يمس ما حول صفحة الدفع:

• أي تعليمات أو صور في موقعك تطلب من العميل "اختر بنكك" أولاً أصبحت قديمة.
• اختبارات الدفع الآلية التي تمر على صفحة كي نت تحتاج تحديثاً.
• ردود خدمة العملاء يجب أن تطابق الشاشة الجديدة.

ربط مباشر مع البنك أم عبر مزود دفع مرخص؟

هناك طريقان للوصول إلى كي نت: عقد بوابة كي نت مع بنك كويتي، أو مزود دفع مرخص من بنك الكويت المركزي يوفر كي نت مع البطاقات الائتمانية وApple Pay.

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

• يقر التاجر بأن السلع والخدمات التي يبيعها مملوكة له، ويتعهد بألا يستخدم الخدمة للتحصيل نيابة عن أطراف أخرى (البند 3.7). أي أن المنصة التي تبيع لحساب عدة تجار لا تناسب هذا النموذج.
• تُحوّل المبالغ المحصلة في اليوم التالي ليوم الدفع (الملحق، البند 12).
• الرسوم والعمولات محددة في نموذج الطلب، ويحق للبنك تعديلها بإخطار خطي قبل شهر على الأقل (البند 5.1).
• التاجر مسؤول عن حماية أي بيانات بطاقات يحفظها وفق معيار PCI DSS، ويحق للبنك مراجعة الموقع وأنظمة أمنه.
• مدة العقد سنة تتجدد تلقائياً، ويجوز إنهاؤه إذا لم تمر أي عملية عبر بوابة كي نت لمدة ستة أشهر (البند 10.1.5).

كيف يبدو الربط المباشر عبر البنك؟

يصدر لك البنك Tranportal ID وكلمة مرور Tranportal ومفتاح المورد (Terminal Resource Key)، وتكتبها وثائق Checkout.com بصيغة Transportal وتسمي المفتاح مفتاح التشفير. ولكي نت بيئة اختبار (kpaytest) منفصلة عن بيئة التشغيل (kpay). يبني خادمك طلب الدفع بهذه البيانات ويحوّل العميل، وعند انتهاء العملية ترسل كي نت النتيجة إلى رابط الاستجابة في موقعك بطريقة POST، أما أخطاء البوابة أو المعالجة فتذهب إلى رابط الخطأ. والعملية الناجحة تعود بالنتيجة CAPTURED، وأي نتيجة أخرى تعني الفشل.

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

الربط عبر مزود دفع مرخص

مزود الدفع يعطيك سرعة وخيارات أكثر مقابل تحكم أقل. ولدى بنك الكويت المركزي سجلات منفصلة: سجل مزودي خدمات الدفع الإلكتروني ويضم تسع شركات، منها تاب (Tap) ويو بيمنتس (UPayments) وحسابي (Hesabe) ضمن فئة المزودين الكبار، وسجل مزودي خدمات النقود الإلكترونية وفيه ماي فاتورة (MyFatoorah) مزوداً كبيراً، ولـربط ماي فاتورة صفحة مستقلة. أما كي نت نفسها فهي الجهة الوحيدة في سجل مشغلي خدمات الدفع الإلكتروني.

رسوم كي نت غير موحدة. البنك يحددها في نموذج طلب الخدمة (البند 5.1 المذكور أعلاه)، والمزودون يسعّرون حسب الباقة، وبعضهم ينشر أسعاره: في 27 سبتمبر 2026 كانت صفحة أسعار يو بيمنتس تذكر رسوم كي نت بواقع (0.5% + 100 فلس) أو (250 فلساً) للعملية في باقتي التاجر الواحد وتعدد التجار، ولكل باقة رسم لمرة واحدة (250 و700 دينار). جمعنا المزودين المرخصين ورسومهم المنشورة في دليل بوابات الدفع الإلكتروني في الكويت. اطلب جدول الرسوم كتابياً واحسبه على حجم طلباتك المتوقع.

ما الذي يجب أن يتوفر في موقعك قبل الموافقة؟

نفس عقد البنك التجاري الكويتي يحدد معلومات يجب أن تظهر بوضوح في موقع التاجر، وهي قائمة مراجعة جيدة قبل الإطلاق أياً كان الطريق الذي تختاره:

• وصف دقيق للسلعة أو الخدمة
• بيانات تواصل كاملة تشمل البريد الإلكتروني وأرقام الهواتف
• سياسة الإرجاع والاسترجاع والإلغاء
• سياسة التوصيل
• بلد المنشأ وقيود التصدير
• سياسة الخصوصية وبيان عن حماية بيانات حامل البطاقة
• متى يُخصم المبلغ من البطاقة وكيف يُنجز الطلب
• تنبيه للعميل بالاحتفاظ بنسخة من إيصال العملية

ولقانون التجارة الرقمية في الكويت متطلبات إضافية، جمعناها في قائمة متطلبات المتجر الإلكتروني. هذا دليل تقني وليس استشارة قانونية.

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

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

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

ربط كي نت في تطبيقات الجوال

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

وبحسب وثائق Amazon Payment Services يسري شرط كي نت على كل مدفوعات Apple Pay في الكويت، لذلك خطط لأن يمر Apple Pay داخل تطبيق iOS عبر كي نت أيضاً. واسأل مزودك كيف يدعم ذلك داخل التطبيقات: وثائق Amazon Payment Services مثلاً تذكر Hosted Checkout وCustom Integration لـ Apple Pay عبر كي نت، ولا تذكر ربط تطبيقات الجوال لديها.

رابط دفع كي نت في واتساب

إذا كان عملاؤك يطلبون عبر واتساب، فرابط دفع كي نت يناسب هذه المحادثة: يؤكد العميل طلبه، ويفتح الرابط، ويدفع في صفحة كي نت، ثم تظهر له صفحة التأكيد ويعود إلى المحادثة.

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

بطاقة كي نت التجريبية وبيئة الاختبار

لكل طريقة ربط بيانات اختبار خاصة بها، وقد يغيرها المزود، فارجع إلى المصدر قبل الاختبار:

• الربط المباشر: البنك المحصّل يصدر بيانات Tranportal تجريبية لبيئة كي نت التجريبية (kpaytest).
• Checkout.com: يجب أن يفعّل مدير الحساب كي نت في بيئة الاختبار، ويذكر دليل واجهة كي نت بطاقة الاختبار التي تستخدمها. وبحسب الدليل نفسه لا يمكن اختبار تسجيل KFast هناك لأنه يحتاج رمز تحقق حقيقياً.
• تاب: بطاقات الاختبار في وثائق تاب.
• ماي فاتورة: بطاقات الاختبار في وثائق ماي فاتورة.

واختبر الحالات الفاشلة بنفس جدية الحالة الناجحة: دفعة ملغاة، ودفعة منتهية الصلاحية، وعميل يغلق الصفحة، وإشعار يصل مرتين، واسترجاع جزئي.

أخطاء شائعة في ربط كي نت

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

كيف نبني صفحات الدفع بالكي نت؟

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