ربط Apple Pay بالمتجر في الكويت: شروط كي نت وإعداد الموقع والتطبيق

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

كيف يعمل Apple Pay للتجار في الكويت؟

تقول وثائق Amazon Payment Services إن تمرير Apple Pay عبر كي نت إلزامي لكل عمليات Apple Pay في الكويت، وتقول وثائق Checkout.com إن معالجة مدفوعات Apple Pay في الكويت يجب أن تتم عبر شبكة كي نت.

العملية الواحدة تسير هكذا:

1. يضغط العميل زر Apple Pay في تطبيقك أو موقعك، ويؤكد بـ Face ID أو Touch ID أو رمز المرور.
2. ترسل Apple رمز الدفع المشفّر (token) إلى التطبيق أو الصفحة.
3. يرسل خادمك، أو بوابة الدفع، رمز الدفع المشفّر للمعالجة عبر كي نت بالدينار الكويتي.
4. يوافق كي نت والبنك المصدر للبطاقة أو يرفضان، وتبلغك البوابة بالنتيجة.

من جهة العملاء، قائمة Apple للبنوك المشاركة، كما راجعناها في 27 سبتمبر 2026، تذكر 11 جهة مصدرة في الكويت: البنك الأهلي الكويتي، وAmerican Express، وبنك بوبيان، وبنك برقان، والبنك التجاري الكويتي، وبنك الخليج، وبيت التمويل الكويتي، وبنك الكويت الدولي، وبنك الكويت الوطني، وبنك وربة، وبنك ويّاي (Weyay).

ما الذي يغيّره مسار كي نت في طريقة البناء؟

صفحة Amazon Payment Services عن Apple Pay عبر كي نت تذكر قيدين، ولكل منهما أثر مباشر على منتجك:

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

وتذكر الصفحة نفسها أن التاجر لدى Amazon Payment Services يستطيع استخدام Apple Pay عبر كي نت من خلال الصفحة المستضافة (Hosted Checkout) أو الربط المخصص (Custom Integration) فقط، ولا تذكر الربط عبر حزمة تطوير التطبيقات (Mobile SDK) لهذا المسار. إذا كنت تخطط لصفحة دفع مدمجة داخل التطبيق (Native) مع هذا المزود، فتحقق أولاً.

وتضيف Checkout.com تفصيلين مفيدين للمبرمج:

• تحتاج ثلاث بيانات من البنك المحصّل لكي نت: Transportal ID وTransportal password ومفتاح التشفير. وإذا كنت تعالج كي نت عبر Checkout.com أصلاً، تستخدم البيانات نفسها.
• لا حاجة لتحويل رمز الدفع المشفّر إلى رمز بطاقة كما في مناطق أخرى. ترسل كائن paymentData من Apple في الحقل token_data، وكائن paymentMethod في الحقل payment_method_details، والعملة KWD. والإشعارات (webhooks) المذكورة لهذا المسار هي payment_pending وpayment_captured وpayment_declined.

قد تصوغ البوابات الأخرى هذه القيود بشكل مختلف أو تقدم خيارات خاصة بها. اسأل بوابتك كتابياً: ما عمليات Apple Pay المدعومة لبطاقات الكويت (الدفع، والاسترجاع، والتكرار)؟ واحصل على الجواب قبل تصميم الدفع والاسترجاع والفوترة.

كم رسوم Apple Pay على التاجر في الكويت؟

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

Apple Pay في الموقع أم في تطبيق iPhone؟

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

الموقع يحتاج عنصرين إضافيين، والجدول يلخص الفرق:

توثيق النطاق في الموقع

تشترط Apple تسجيل وتوثيق كل نطاق رئيسي وفرعي يظهر فيه زر Apple Pay. لا يجوز أن يكون النطاق خلف وكيل (proxy) أو تحويل (redirect)، ويجب أن تصل خوادم Apple إلى ملف التوثيق على الرابط /.well-known/apple-developer-merchantid-domain-association. إذا كان موقعك يحوّل النطاق بدون www (مثل example.com) إلى www، فوثّق النطاق الذي تظهر عليه صفحة الدفع فعلاً. ويعمل Apple Pay في الموقع عبر Apple Pay JS أو Payment Request API.

أن تتولى بوابة الدفع إعدادات Apple

لا تحتاج دائماً حساب مطور خاصاً بك للموقع. تقول وثائق تاب لحزمة Apple Pay للويب إن تاب تسجّل نطاق التاجر لدى Apple Pay نيابة عنه، وإن المدفوعات تُعالج بشهادة Apple Pay الخاصة بتاب، فلا يحتاج التاجر الدخول إلى بوابة مطوري Apple ولا تبادل ملفات CSR وCER. يبقى عليك نشر ملف التوثيق في مسار .well-known، وإرسال كل النطاقات الفرعية لتاب مسبقاً، واستخدام معرّف التاجر الذي تزودك به.

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

خطوات الإعداد عبر كي نت بمعرّف تاجر خاص بك

إذا كنت تعالج الدفع عبر كي نت بحساب مطور خاص بشركتك، يصف دليل Amazon Payment Services التسلسل التالي. هذه خطوات APS للتجار الذين ينقلون معالجة Apple Pay الحالية إلى كي نت، وقد تختلف لدى البوابات الأخرى.

1. ادخل إلى بوابة التجار في كي نت: بيئة الاختبار على kpaytest.com.kw والتشغيل الفعلي على kpay.com.kw.
2. من قسم إعدادات الطرفية (Terminal Settings)، أنشئ طلب توقيع الشهادة (CSR) ونزّله.
3. في حساب المطور لدى Apple، أنشئ معرّف تاجر لحساب الدينار الكويتي، وتنصح APS بمعرّف جديد لأن استخدام المعرّف الحالي لهذه الشهادة يؤثر على مدفوعاتك القائمة.
4. استخدم ملف CSR من كي نت لإنشاء شهادة معالجة الدفع لهذا المعرّف.
5. ارفع ملف .cer الناتج إلى بوابة كي نت.
6. حدّث تطبيقك لتذهب عمليات Apple Pay إلى الحساب الفرعي الجديد، إذ تنشئ APS حساباً فرعياً مستقلاً لـ Apple Pay بالدينار.

وتنصح Checkout.com بطلب دليل ربط Apple Pay للتجار من كي نت، واتباع القسم الخاص بإضافة شهادة معالجة الدفع إلى بوابة الدفع، ثم الاختبار ببيانات البنك المحصّل في بيئة الاختبار لدى كي نت قبل الإطلاق.

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

ماذا يعني ذلك للاشتراكات والطلبات المسبقة؟

هنا يظهر أثر مسار كي نت أكثر من أي مكان آخر.

الاشتراكات الرقمية داخل تطبيق iPhone

إذا كان تطبيقك يبيع الوصول إلى خصائص أو محتوى، مثل باقة مميزة أو دروس مدفوعة، فإن إرشادات مراجعة App Store في البند 3.1.1 تشترط الشراء داخل التطبيق. وفي متجر App Store في الكويت، يعني ذلك بيع المحتوى الرقمي بالشراء داخل التطبيق، لا بـ Apple Pay داخل التطبيق. والبند 3.1.3(e) يقول العكس للسلع المادية والخدمات التي تُستهلك خارج التطبيق: يجب استخدام وسيلة غير الشراء داخل التطبيق، مثل Apple Pay أو إدخال البطاقة.

اشتراكات السلع والخدمات المادية

اشتراك الوجبات أو النادي الرياضي أو عقد التنظيف الشهري يقبل Apple Pay. لكن Amazon Payment Services تذكر أن عمليات Apple Pay عبر كي نت لا تدعم العمليات المتكررة، فلا يمكنك في هذا المسار حفظ رمز الدفع (token) والخصم منه تلقائياً كل دورة. اسأل بوابتك كتابياً إن كانت تقدم خياراً للدفع المتكرر عبر Apple Pay لبطاقات الكويت. وإلى أن تؤكد ذلك، هذه الحلول العملية:

• الدفع مع كل دورة: أرسل رابط دفع أو تنبيهاً داخل التطبيق قبل التجديد، ويدفع العميل مجدداً بـ Apple Pay.
• الاشتراك المدفوع مقدماً: اعرض اشتراك 3 أو 6 أو 12 شهراً بدفعة واحدة.
• البطاقة المحفوظة للتجديد: خذ الدفعة الأولى بـ Apple Pay، واعرض الفوترة بالبطاقة للتجديدات، فقط إذا أكدت بوابتك دعم الخصم من البطاقات المحفوظة في الكويت. وهذا منتج منفصل عن Apple Pay.

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

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

الطلبات المسبقة والعربون والمبالغ المتغيرة

في مسار لا يدعم التفويض المسبق لا يوجد "احجز الآن وحصّل عند الشحن". الخيارات العملية:

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

كيف تحافظ على عمل Apple Pay بعد الإطلاق؟

يتوقف Apple Pay بصمت عندما تنتهي صلاحية شيء ما. حسب وثائق Apple عن صيانة الإعداد:

• شهادة معالجة الدفع تنتهي كل 25 شهراً.
• شهادة هوية التاجر تنتهي كل 25 شهراً.
• توثيق النطاق ينتهي مع انتهاء شهادة SSL للنطاق، وتتحقق Apple من تجديدها قبل 30 و15 و7 أيام. إذا انتهت شهادة SSL دون تجديد، يجب توثيق النطاق من جديد.
• ترسل Apple تذكيرات الانتهاء إلى صاحب دور Admin وصاحب الحساب (Account Holder).

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

قبل الإطلاق: قائمة فحص سريعة

1. نفّذ عمليات تجريبية في بيئة اختبار كي نت ببيانات الاختبار من البنك المحصّل.
2. ادفع من iPhone حقيقي ببطاقة كويتية مضافة إلى المحفظة، ثم نفّذ استرجاعاً.
3. تأكد أن النطاق الذي تظهر عليه صفحة الدفع (مع www أو بدونها) هو النطاق الموثّق.
4. في تطبيق iOS، اعرض كل معلومات الشراء الجوهرية قبل البيع، واستخدم شعار Apple Pay وعناصر واجهته كما تصفها إرشادات Apple (البند 4.9).

أي مسار يناسبك؟

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

ما الذي تقدمه ركن في ربط Apple Pay بالتطبيقات والمتاجر؟

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