البوابة ليست زراً في صفحة الدفع. هذا المقال يفصل الحالات والمسؤوليات والاختبارات والتسوية التي تحدد ما إذا كان التكامل يعمل بعد الإطلاق.
عندما تقول «نحتاج ربط بوابة دفع»، فأنت لا تصف مهمة واحدة. أنت تصف سلسلة من الحالات: طلب يُنشأ، ومبلغ يُحجز، وبطاقة تُرفض، واسترداد يُطلب، وتسوية تُطابق آخر الشهر. البوابة ليست زراً في صفحة الدفع. هي عقد بين متجرك ومزود الدفع والبنك، وكل طرف فيه له مسؤولية مختلفة عندما يحدث خطأ.
هذا المقال يفصل ما يجب أن يكون داخل نطاق التكامل، وما يُترك خارجه عادةً، وكيف تختبره قبل أن تفتح المتجر. لا نناقش الرسوم أو نسب العمولة، لأنها تختلف بعقدك وحجمك ونوع نشاطك. نناقش ما يجعله يعمل: الحالات، والمسؤوليات، والاختبارات، والتسوية.
ما تفعله البوابة وما لا تفعله
البوابة تنقل بيانات الدفع إلى الجهة التي تصدر القرار، وتعيد النتيجة إلى متجرك، وتوفر واجهة لإدارة العمليات لاحقاً. هي لا تمنحك تمويلاً، ولا تحل محل البنك في التسوية، ولا تجعل الاحتيال يختفي. في السعودية، مدى شبكة محلية للبطاقات، وApple Pay وSTC Pay طرق إضافية، والبطاقات الدولية تأتي عبر مزودي البطاقات. كل طريقة لها مسار تفويض مختلف قليلاً، حتى لو بدت صفحة الدفع واحدة.
لذلك لا تسأل «هل تدعمون مدى؟» فقط. اسأل: هل تدعم مدى للبطاقات المحلية والدولية في العقد نفسه؟ هل تدعم الاسترداد الجزئي؟ هل ترسل إشعاراً عند تغيّر حالة الدفع؟ هل لديك بيئة اختبار تعمل بنفس سلوك الإنتاج؟ هذه الأسئلة تكشف الفرق بين تكامل يُطلق وتكامل يُدار.
الحالات التي يجب أن تصممها
| الحالة | ما يجب أن يحدث | الخطأ الشائع |
|---|---|---|
| تفويض ناجح | الطلب ينتقل إلى حالة مدفوع، والمخزون يُحجز، والعميل يرى تأكيداً | تأكيد يظهر قبل وصول إشعار الدفع |
| بطاقة مرفوضة | رسالة واضحة، والطلب يبقى قابلاً لإعادة المحاولة | إنشاء طلب مكرر عند كل محاولة |
| انتهاء مهلة الرد | الطلب يبقى معلقاً، ويُتحقق من الحالة قبل اعتباره فاشلاً | اعتبار الصمت رفضاً وطلب دفع آخر |
| استرداد كامل | المبلغ يعود، والطلب يُحدَّث، والعميل يُبلَّغ | استرداد في البوابة دون تحديث المتجر |
| استرداد جزئي | المبلغ والمخزون والفاتورة تتغير معاً | تعديل الفاتورة يدوياً لاحقاً |
| تكرار الإشعار | نفس الحدث يُعالج مرة واحدة فقط | خصم مخزون مرتين لنفس الطلب |
| تسوية نهاية الشهر | مبلغ البوابة يطابق مبيعات المتجر والاستردادات | فرق لا يجد من يفسره |
الطبقة المحلية: مدى والفوترة
مدى ليست مجرد خيار في قائمة. هي شبكة بطاقات محلية، ولها متطلبات في التفويض والاسترداد والتسوية. إذا كان متجرك يبيع للأفراد، فدعم مدى ليس تحسيناً بل شرط للعمل. وإذا كنت تبيع للشركات، فقد تحتاج إلى تحويل بنكي أو آجل، ولكل منهما دورة حياة مختلفة: طلب، ثم موافقة، ثم سداد، ثم مطابقة. لا تخلط بينهما في شاشة واحدة.
الفاتورة الضريبية ليست ملحقاً للدفع. هي سجل محاسبي يجب أن يعكس المبلغ المدفوع والضريبة والاسترداد. عندما يتغير الطلب بعد الدفع، يجب أن تتغير الفاتورة أو تُصدر فاتورة تصحيحية وفق القواعد المعمول بها. أسهل طريقة لخلق مشكلة محاسبية هي بناء الدفع أولاً ثم محاولة إلحاق الفوترة به. ابدأ من الفاتورة، ثم ابنِ الدفع حولها.
القياس يبدأ من هنا أيضاً. متوسط التخلي عن السلة 70.19% في خمسين دراسة وفق Baymard، و22% من المستخدمين تخلوا لأن الدفع طويل أو معقد، ومتوسط النموذج 11.3 حقلاً. إذا كانت صفحة الدفع لديك تطلب حقولاً لا تحتاجها، فأنت تخسر قبل أن تصل إلى البوابة. مقال إصلاحات تحويل الدفع في السعودية يعرض الأخطاء التي نراها أولاً.
من القراءة إلى التنفيذ
تريد بناء هذا، لا قراءته فقط؟
أرسل لنا المشكلة التي تقف خلف المقال. سنخبرك بما يتطلبه الحل وتكلفته وما إذا كنا الفريق المناسب.
مصفوفة الاختبار قبل الإطلاق
لا تختبر في الإنتاج. اطلب بيئة اختبار تعمل بنفس منطق الإنتاج، ثم اختبر الحالات التالية. إذا لم تُغطَّ، فالتكامل غير مكتمل حتى لو ظهرت رسالة نجاح في الشاشة.
بطاقة ناجحة: طلب كامل حتى الفاتورة والتأكيد، مع مطابقة المبلغ والضريبة.
بطاقة مرفوضة: رسالة مفهومة، وطلب واحد فقط، وإمكانية إعادة المحاولة دون تكرار.
مهلة زمنية: محاكاة تأخر الرد، والتأكد من أن الطلب لا يُعتبر فاشلاً قبل التحقق.
استرداد كامل: من لوحة البوابة ومن لوحة المتجر، ومطابقة الحالة في الاثنين.
استرداد جزئي: تغيّر المبلغ والفاتورة والمخزون، مع سجل واضح للمستخدم.
إشعار مكرر: إعادة إرسال نفس الحدث، والتأكد من عدم خصم المخزون مرتين.
طلب بلا عنوان: رفض واضح قبل الدفع، لا بعده، ورسالة تشرح ما ينقص.
تسوية: مطابقة تقرير البوابة مع مبيعات المتجر والاستردادات لليوم نفسه.
نطاق PCI والمسؤولية
عندما تمرر بيانات البطاقة عبر خادمك، فإنك توسع نطاق الامتثال لمعيار PCI. الحل الأبسط هو ألا تلمس بيانات البطاقة أصلاً: استخدم حقلاً مستضافاً أو إعادة توجيه إلى صفحة الدفع لدى المزود، بحيث تبقى البيانات خارج نظامك. هذا لا يلغي المسؤولية، لكنه يقلل ما يجب أن تثبته لاحقاً. اسأل مزودك أي نموذج تكامل يقترح، وما الذي يبقى على خادمك.
المسؤولية لا تتوقف عند البوابة. من يملك مفتاح API؟ من يرى سجلات الدفع؟ من يوافق على الاسترداد؟ من يطابق التسوية؟ من يجيب العميل عندما يقول إن المبلغ خُصم مرتين؟ اكتب هذه الأدوار في وثيقة التشغيل قبل الإطلاق. التكامل الذي لا يعرف فيه أحد من يفعل ماذا سينتهي بمشكلة دعم لا مشكلة تقنية.
الأسئلة الشائعة
هل يمكن ربط أكثر من بوابة؟ نعم، لكن كل بوابة تضيف حالة إضافية وتسوية إضافية. ابدأ بواحدة تغطي احتياجك الأساسي، وأضف الثانية عندما يكون لها سبب تجاري واضح.
هل نحتاج إلى 3-D Secure؟ يعتمد على مزودك ونوع البطاقة واللوائح المطبقة. اسأل عن المسارين: التحدي والتمرير، وكيف يظهر كل منهما للمستخدم.
كم يستغرق التكامل؟ يعتمد على عدد الطرق والحالات، لكنه عادةً جزء من نطاق المتجر لا مشروع منفصل. اختبره مبكراً، لا في الأسبوع الأخير.
من يتحمل رسوم الاسترداد؟ هذا بند تعاقدي مع المزود، لا قرار تقني. اقرأه قبل التوقيع.
هل تدعمون Apple Pay وSTC Pay؟ نعم، عبر المزود الذي يدعمهما في عقدك. نتحقق من كل طريقة باختبار فعلي، لا بافتراض.
ماذا يحدث إذا تعطلت البوابة؟ تحتاج إلى خطة: رسالة واضحة، ومسار بديل إن وُجد، ومراقبة تنبه شخصاً، لا صفحة خطأ صامتة.
المصادر
- Baymard: سهولة الدفع — 11.3 حقلاً في المتوسط، و22% تخلوا بسبب طول الدفع.
- Baymard: معدل التخلي عن السلة — متوسط 70.19% عبر 50 دراسة.
- تكاملات رصد — زاتكا ونفاذ ومدى وأنظمة ERP، وكيف يُختبر كل منها.
- تطوير التجارة الإلكترونية — النطاق والعملية والتسليم.
- نطاقات رصد السعرية — الأرقام التي يعمل بها هذا المقال.

