كيف تربط تاب (Tap Payments) بموقعك وتطبيقك في الكويت

تاب للدفع الالكتروني (Tap Payments) مزوّد دفع مدرج في سجل بنك الكويت المركزي، وبحسب وثائقه يمكن ربطه بموقعك أو تطبيقك لاستقبال كي نت وApple Pay والبطاقات، ومعها مدى وبنفت إذا فعّلتها تاب على حسابك وكنت تبيع في السعودية أو البحرين.

يغطي هذا الدليل الترخيص، والرسوم ومواعيد التحويل، ووسائل الدفع، وخطوات الربط للموقع وتطبيق React Native (Expo)، والاختبار في البيئة التجريبية. المعلومات من سجل بنك الكويت المركزي ووثائق تاب للمطورين ومركز المساعدة لديها (ومن وثائق Amazon Payment Services فيما يخص Apple Pay عبر كي نت)، كما راجعناها في 27 سبتمبر 2026.

هل تاب مرخصة في الكويت؟

حتى 27 سبتمبر 2026، نعم. يحتفظ بنك الكويت المركزي بـسجل منشور لمقدمي خدمات الدفع الإلكتروني، وفيه شركة Tap Payments e-Payment Service Provider (KSCC) ضمن الفئة الكبيرة، وعنوانها في السالمية، وموقعها www.tap.company.

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

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

رسوم تاب ومواعيد التحويل وتفعيل كي نت

حتى 27 سبتمبر 2026 لم نجد جدول رسوم منشورا للكويت على موقع تاب، فنسبة العمولة تحدد بعرض سعر حسب نشاطك، فاطلبه مكتوبا. لكن مركز المساعدة لدى تاب ينشر ما يلي:

إذا كان أغلب عملائك يدفعون بالبطاقات، فخطط للسيولة على أساس دورة الأيام الخمسة للبطاقات، لا دورة اليومين في كي نت.

وسائل الدفع المتاحة عبر ربط واحد مع تاب

في تاب، تمر كل وسائل الدفع عبر الواجهة نفسها لإنشاء عمليات الدفع (Charge API). الذي يتغير هو قيمة source.id والعملة. والفرق الحقيقي بين الوسائل هو مسار الدفع والعملة المسموحة.

وتذكر صفحة بطاقات الاختبار لدى تاب أيضا NAPS/QPay في قطر، وSTC Pay في السعودية، وOmanNet في عُمان. اسأل تاب أيها يمكن تفعيله على حسابك الكويتي.

طرق الربط الأربع مع تاب

1. صفحة الدفع المستضافة: ينشئ خادمك العملية، ويدفع العميل في صفحة تاب. أقل برمجة وأقل تحكم في التصميم، ويظهر فيها Apple Pay ومدى دون إعداد إضافي.
2. أداة البطاقات (Card SDK): تظهر حقول البطاقة داخل صفحتك أو تطبيقك، وتعيد رمزا لمرة واحدة يستخدمه خادمك لإتمام الدفع. تتحكم في شكل صفحة الدفع دون التعامل مع أرقام البطاقات.
3. الإضافات الجاهزة: بحسب صفحة النظرة العامة لدى تاب، بنى فريقها التقني إضافات لـ WooCommerce وMagento وOpenCart. ولشوبيفاي تذكر إضافة مدمجة بنتها تاب، وإضافة تحوّل العميل إلى صفحة الدفع بناها شركاؤها.
4. نموذج بطاقات خاص بك: فقط إذا كانت لديك شهادة PCI DSS سارية وشهادة امتثال، وعندها تشاركك تاب مفتاح RSA لتشفير بيانات البطاقة. وهذا المسار لمن يحمل هذه الشهادة فقط.

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

خطوات ربط تاب بالموقع الإلكتروني

1. المفاتيح: سجّل في تاب، واحصل على مفاتيح الاختبار والتشغيل من لوحة التحكم. لكل بيئة مفتاح سري ومفتاح عام. يوضع المفتاح السري في متغيرات بيئة الخادم فقط، ووثائق تاب واضحة في أنه لا يوضع في الواجهة الأمامية (Frontend) أبدا.
2. تسجيل النطاق: سجّل لدى تاب اسم النطاق الذي يحمّل أدواتها، ويشمل ذلك زر Apple Pay.
3. إنشاء العملية من الخادم: أرسل المبلغ والعملة وبيانات العميل وsource.id ورابط العودة redirect.url ورابط الإشعار post.url. في كي نت وبنفت يعيد رد الواجهة حالة INITIATED ومعها transaction.url، فحوّل العميل إليه.
4. عودة العميل: تعيد تاب العميل إلى رابط العودة ومعه المعامل tap_id. استعلم عن العملية من خادمك قبل أن تعرض "تم الدفع"، ولا تعتمد على الرابط وحده.
5. الإشعار من الخادم: تصل الحالة النهائية إلى post.url، ومنه تعتمد الطلب بعد التحقق من التوقيع.
6. الاسترداد: عبر واجهة الاسترداد (Refunds API) في تاب. أرسل post.url مع طلب الاسترداد لتصلك النتيجة على خادمك، ووثيقة الإشعارات لدى تاب تشرح طريقة حساب التوقيع للاسترداد أيضا. واستعلم عن الاسترداد من الواجهة قبل تحديث الطلب.

لكي نت قواعد خاصة بها مهما كانت بوابة الدفع، وقد جمعناها في دليل ربط كي نت بالموقع.

ربط تاب مع تطبيق React Native (Expo)

بحسب وثائق تاب للمطورين، توفر تاب حزم React Native للبطاقات وApple Pay وصفحة الدفع الكاملة، إلى جانب حزم Flutter وiOS (Swift) وAndroid (Kotlin). وفي تطبيق مبني بـ Expo نعتمد هذا الهيكل:

1. إنشاء العملية من الخادم. يستدعي التطبيق واجهتك أنت، وهي تنشئ العملية بالمفتاح السري وتعيد ما يحتاجه التطبيق فقط، مثل رابط transaction.url في كي نت.
2. فتح طرق التحويل في متصفح داخل التطبيق. افتح رابط العملية بـ expo-web-browser، واجعل redirect.url صفحة على نطاقك تعيد العميل إلى التطبيق عبر Universal Link أو مخطط الروابط الخاص بتطبيقك.
3. الحزم الأصلية في نسخة تطوير. حزم تاب للبطاقات وApple Pay في React Native وحدات أصلية (Native)، فتعمل في نسخة تطوير من Expo (Development Build) لا في Expo Go. وسجّل معرّف التطبيق (Bundle ID) لدى تاب وإلا لن تعمل الحزم.
4. الأسرار على الخادم. إنشاء العملية، والاستعلام عن حالتها، وأي توقيع (hash string) تحتاجه الحزمة، كلها على خادمك. وتصف وثائق تاب لحزمة الدفع الكاملة في Flutter هذا التوقيع بأنه HMAC-SHA256 يُنشأ بمفتاحك السري. التطبيق يحمل المفتاح العام فقط.
5. التأكيد من الخادم. لا يُعتمد الطلب إلا بعد أن يقرأ خادمك حالة العملية من تاب ومن الإشعار (Webhook).

بديل Flutter. إذا كان تطبيقك مبنياً بـ Flutter، فوثائق تاب تذكر لـ Flutter أداة البطاقات وأداة الدفع الكاملة (Checkout) وأداة Apple Pay. ومثال تاب لأداة الدفع الكاملة ينشئ التوقيع داخل التطبيق بلغة Dart، أما في التشغيل الفعلي فأنشئه على خادمك وأرسله إلى التطبيق. وتنطبق القواعد نفسها: تسجيل معرّف التطبيق، والمفتاح السري على الخادم، والتأكيد من الخادم.

Apple Pay عبر تاب في الكويت

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

• على الموقع: Apple Pay لا يعمل داخل iframe أو نافذة منبثقة، لذلك تقترح وثائق تاب إضافة زر مستقل لـ Apple Pay في صفحة الدفع.
• في صفحة تاب المستضافة: يظهر تلقائيا دون إعداد.
• المرور عبر كي نت: تذكر وثائق Amazon Payment Services أن مرور Apple Pay عبر كي نت إلزامي لعمليات Apple Pay في الكويت، وأنه لا يدعم التفويض المسبق ولا الدفعات المتكررة. وتذكر وثائق تاب لكي نت أن الدفع ببطاقة كي نت يدعم التفويض المسبق. وحتى 27 سبتمبر 2026 لم نجد في وثائق تاب شرحا لمسار Apple Pay، فإذا كنت تخطط لاشتراكات أو تفويض مسبق بالدينار الكويتي فاسأل تاب كتابيا.

تفاصيل إعداد Apple Pay من جهة Apple في دليل ربط Apple Pay بالمتجر.

إشعارات الخادم والتوقيع والخانات العشرية

إذا أهملت الإشعار ضاعت الطلبات: العميل دفع، لكن نظامك لم يعلم بذلك.

• بحسب وثائق الإشعارات لدى تاب، ترسل تاب الإشعار في حالتين فقط: CAPTURED (تم الدفع) وFAILED (فشل). أما العمليات بحالة INITIATED أو ABANDONED فلا يصل عنها إشعار، وتبقى حالة الإشعار PENDING.
• إذا لم يستجب رابطك، تحاول تاب مرتين إضافيتين ثم تسجل الحالة ERROR. لذلك تحتاج مهمة دورية تستعلم عن العمليات المعلقة.
• لا يمكن إرسال الإشعار إلى localhost، فاستخدم خادما تجريبيا متاحا على الإنترنت.
• كل إشعار يحمل ترويسة hashstring تعيد حسابها بخوارزمية HMAC-SHA256 وبمفتاحك السري ثم تقارن.
• المبلغ يُكتب بعدد خانات العملة قبل الحساب: ثلاث خانات للدينار الكويتي والبحريني (3.000) وخانتان للريال والدرهم. طلب بقيمة 12.5 دينار يُحسب بصيغة 12.500، وأي صيغة أخرى تفشل.

ولهذا لا يكفي رابط العودة: قد يغلق العميل المتصفح بعد الدفع، لكن الإشعار يصل ويُعتمد الطلب.

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

مفاتيح الاختبار تنشئ عمليات في بيئة تاب التجريبية. تنشر تاب صفحة بطاقات الاختبار وفيها بطاقات كي نت وبنفت ومدى وNAPS/QPay وفيزا وماستركارد وأمريكان إكسبريس وOmanNet، وأرقام STC Pay للاختبار.

في كي نت، توضح صفحة تاب البنك التجريبي الذي تختاره من قائمة البنوك في صفحة اختبار كي نت، وتذكر بطاقات اختبار وتواريخ انتهاء تعطي CAPTURED أو NOT CAPTURED. وفي البطاقات الائتمانية تعطي تواريخ انتهاء محددة DECLINED أو EXPIRED_CARD أو TIMED_OUT. قد تغير تاب هذه القيم، فانسخها من صفحتها قبل كل اختبار.

خطة اختبار قصيرة قبل الإطلاق:

• عملية ناجحة وأخرى فاشلة لكل وسيلة دفع مفعلة، مع التأكد أن حالة الطلب تتغير من الإشعار لا من رابط العودة.
• عميل يغلق الصفحة وهو في صفحة كي نت.
• إشعار بمبلغ معدّل، ويجب أن يرفضه نظامك.
• استرداد جزئي وآخر كامل إذا كنت تقبل المرتجعات.
• صفحة الدفع بالعربية والإنجليزية على جوال حقيقي، وفي Safari لتجربة Apple Pay.

البيع في السعودية أو البحرين عبر تاب

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

مثال افتراضي: علامة عطور كويتية تبيع بالدينار الكويتي وتريد متجرا للبحرين. تضيف قائمة أسعار بالدينار البحريني، وتطلب من تاب تفعيل بنفت، وتوجه طلبات البحرين إلى src_bh.benefit. أما منطق الطلبات والاسترداد والتسويات فيبقى كما هو. وهل تحتاج حسابا تجاريا أو كيانا قانونيا في البحرين أو السعودية؟ هذا تقرره تاب عند فتح الحساب، فاسأل قبل البرمجة.

ولمزودي الدفع المرخصين الآخرين راجع دليل بوابات الدفع الإلكتروني في الكويت ودليل ربط ماي فاتورة.

قبل التشغيل الفعلي

• استبدل مفاتيح الاختبار بمفاتيح التشغيل على الخادم وفي إعدادات التطبيق أو أداة الموقع.
• اجعل رابط العودة ورابط الإشعار على نطاقك الفعلي وبشهادة HTTPS.
• اطلب من تاب تفعيل كل وسيلة تحتاجها، مثل Apple Pay وبنفت.
• نفّذ عملية حقيقية صغيرة لكل وسيلة دفع على الموقع والتطبيق، ثم استردها.
• احفظ رقم عملية تاب ورقم طلبك في كل طلب لتسهيل التسوية.

كيف تنفذ ركن ربط تاب؟

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

أرسل لنا وسائل الدفع التي تحتاجها والدول التي تبيع فيها عبر صفحة التواصل، ونرد عليك بخطة الربط والتكلفة.