تكامل API تاب باي لمتاجر الكويت

ماذا نقدم

نقدّم تكاملًا كاملًا لـ Tap Payments لمتجرك أو تطبيقك في الكويت بمعدل ١٠ د.ك في الساعة. الخدمة تغطي تكامل Charges API الإصدار الثاني، صفحة دفع مستضافة أو مدمجة بـ Tap Card SDK، Webhook مع التحقق من توقيع HMAC-SHA256، إيصالات ثنائية اللغة بالعربية والإنجليزية مع دعم اليمين إلى اليسار وعملة الدينار بثلاث منازل عشرية، تدفق الاسترجاع الكامل والجزئي عبر /v2/refunds، تقسيم المدفوعات للمنصات متعددة البائعين عبر Destinations API، ودعم Apple Pay و Google Pay كاملًا. كذلك نتولى ملف KYC لـ Tap (السجل التجاري، هوية الموقع، الآيبان، إثبات النشاط) وتقديمه نيابة عنك.

لماذا Tap Payments مهمة للشركات الكويتية

تأسست Tap في الكويت عام ٢٠١٤ ومرخّصة الآن في كل الأسواق الخليجية الستة — الكويت والسعودية والإمارات والبحرين وعمان وقطر — مع تحصيل مخصّص لكل دولة. للتاجر الكويتي الذي يبيع للمتسوق السعودي (أكبر سوق تجارة إلكترونية في المنطقة) بدون فتح كيان قانوني في السعودية واتفاقية مدى منفصلة، Tap هي الحل العملي. تعطيك الكي نت لقاعدتك المحلية، ومدى لبطاقات السعودية، وBenefit للبحرين، وآبل باي في كل مكان — تحت عقد API واحد وجدول تسوية واحد.

تجربة المطور هي السبب الآخر الذي خلى Tap تأكل حصة سوقية من البوابات الكويتية الأقدم. الـ API بصيغة REST + JSON، والتوثيق صادق حول الحالات الاستثنائية، ولوحة التحكم تعرض نفس البيانات اللي يرجعها الـ API، و Webhooks تشمل الحدث الخام كاملًا (مو مجرد إشعار). للعملاء الناطقين بالعربية، صفحة Tap المستضافة معرّبة بالكامل وتدعم اليمين إلى اليسار، شاملة تدفق OTP على آبل باي ومدى.

مراحل التكامل

١. اليوم الأول — فتح الحساب و KYC. نحضّر ملف Tap (السجل التجاري وهوية الموقع والآيبان) ونختار مفاتيح Sandbox و Live، ونقرّر بين الدفع المستضاف والمدمج حسب موقعك. ٢. اليوم الثاني — تكامل Sandbox. نربط Charges API (POST /v2/charges) كاملًا على Sandbox، نسجّل عنوان Webhook، ونختبر سيناريوهات الكي نت الناجحة والمرفوضة وفيزا 3DS وآبل باي وبطاقة مدى تجريبية للعملاء السعوديين. ٣. اليوم الثالث — تجربة الدفع والإيصالات. نطبّق هوية متجرك على Tap Card SDK لو مدمج، ونرتّب الوسائل حسب البلد (الكي نت أولًا للكويت ومدى أولًا للسعودية)، ونختبر الإيصالات العربية بخط Cairo. ٤. اليوم الرابع — Webhooks والاسترجاع والحالات الاستثنائية. التحقق من التوقيع، مفاتيح Idempotency، منع الإرسال المزدوج، انتهاء صلاحية العملية، الاسترجاع الجزئي، وتقسيم المدفوعات للمنصة عند الحاجة. ٥. اليوم الخامس — الإطلاق. نستبدل المفاتيح بإصدار Live (مشفّرة في التخزين وغير مرفوعة لـ Git أبدًا)، نُجري عملية حقيقية بدينار واحد، نربط المراقبة وتنبيهات Slack، ونسلّم Runbook لفريقك.

التقنيات والميزات المدعومة

• المنصات: Shopify (تطبيق دفع مخصص)، WooCommerce (بلجن Tap الرسمي أو مخصص)، Magento 2، سلة، زد، Laravel، Node.js، Django، Rails، Flutter (Tap Flutter SDK)، React Native، iOS و Android الأصليين.
• وسائل الدفع: الكي نت (الكويت)، فيزا، ماستركارد، أمريكان إكسبريس، آبل باي، Google Pay، مدى (السعودية)، Benefit (البحرين)، KNPS، tokens البطاقات المحفوظة، ودعم الاشتراكات الدورية.
• نقاط النهاية: POST /v2/charges و GET /v2/charges/{id} و POST /v2/refunds و POST /v2/destinations (المنصات) و POST /v2/customers (البطاقات المحفوظة)، مع التحقق من توقيع Webhook عبر HMAC-SHA256.
• التسوية: خاصة بكل دولة — التاجر الكويتي يحصل الدينار خلال يومي عمل (T+٢) إلى آيبان محلي، والعمليات عبر الخليج تتسوّى بعملتك أو بعملة المشتري حسب الإعداد.
• التوافق: Tap حاصلة على شهادة PCI-DSS Level 1، فبيانات البطاقة لا تمرّ على خادمك، ونستخدم Tokenization للعملاء المتكررين والاشتراكات.

تفاصيل الأسعار

البند	الساعات	التكلفة (١٠ د.ك/ساعة)
فتح حساب Tap وملف KYC	٣	٣٠ د.ك
تكامل Charges API (Sandbox و Live)	٥	٥٠ د.ك
Webhook مع التحقق من HMAC	٣	٣٠ د.ك
Tap Card SDK المدمج أو الصفحة المستضافة	٥	٥٠ د.ك
إيصالات عربية وإنجليزية	٤	٤٠ د.ك
تدفق الاسترجاع الكامل والجزئي	٤	٤٠ د.ك
التحقق من نطاق آبل باي وGoogle Pay	٣	٣٠ د.ك
الانتقال من Sandbox إلى Live	٣	٣٠ د.ك
المجموع المعتاد	٣٠	٣٠٠ د.ك

KuwaitDev مقابل شركات التكامل العادية

ما تحتاجه	KuwaitDev	شركة عادية
ملف KYC مقبول من أول مرة	نعم — نحضّر الملف كاملًا	تطارد الموافقة أسابيع
التحقق من توقيع HMAC على Webhook	دائمًا	يُهمل غالبًا
آبل باي وGoogle Pay من أول يوم	ملف النطاق ومعرّف التاجر جاهزان	يُطلب كمشروع منفصل
تقسيم المدفوعات للمنصة	Destinations API مُربوط	”نشتغل ببائع واحد فقط”
استرجاع من لوحة الإدارة	جاهز بسجل مراجعة	يُنفّذ يدويًا من Dashboard
فوترة شفّافة ١٠ د.ك/ساعة	فاتورة مفصّلة	عرض ثابت بتكاليف خفية

دراسات حالة

منصة أزياء في السالمية — تقسيم مدفوعات لبائعين متعددين. المنصة عندها ٤٠+ بائع في الكويت والسعودية، وتدفع لهم تحويل بنكي يدوي كل أسبوعين. ربطنا Destinations API علشان كل دفعة تنقسم وقت التحصيل — رسوم المنصة تُحتجز، وحصة البائع تروح لآيبانه بالدينار أو الريال. النتيجة: نزلت دفعات البائعين من ١٤ يومًا إلى T+٢، صفر ساعات مطابقة أسبوعيًا (كانت ٢٢ ساعة)، وزيادة ١٨٪ في تسجيل البائعين خلال ٩٠ يومًا.

شركة SaaS ناشئة في حولي — اشتراكات دورية عبر الخليج. كانت تبيع لـ B2B لعيادات في الكويت والسعودية والإمارات لكن تقبل الكي نت فقط، ونسبة فشل التجديد ٣٨٪. ركّبنا Tap مع Customers API و tokens للاشتراك الشهري، وضبطنا مدى لعيادات السعودية ودرهم للإمارات، وبنينا بوابة فوترة داخل التطبيق. النتيجة: نسبة نجاح التجديد قفزت من ٦٢٪ إلى ٩٤٪، صفر مطابقات تحويل بنكي شهريًا، ومتوسط تفعيل حساب جديد ٣٫٢ يومًا بدل ١١.

متجر مجوهرات راقي في الشرق — Apple Pay أولًا. المتجر يبيع منتجات ٥٠٠-٥٠٠٠ د.ك لكن الدفع كان ٤ خطوات يأخذ ٩٠ ثانية على الجوال ونسبة الترك ٧١٪. أعدنا بناء الدفع على الجوال حول تدفق Apple Pay من Tap — لمسة واحدة على iOS، مع الكي نت وفيزا كخيار احتياطي. النتيجة: نزل وقت الدفع من ٩٠ ثانية إلى ١١ ثانية، انخفاض ٤٣٪ في ترك السلة على الجوال، وصفر عمليات فاشلة في ٦ أشهر على طلبات Apple Pay.