دليل تقني وتجاري شامل لإضافة بوابة الدفع فوري إلى موقعك أو تطبيق التجارة الإلكترونية. يتناول خطوات تكامل واجهات البرمجة (API)، وآليات الاختبار، والرسوم، وأشهر المشكلات التي قد تواجهها مع حلول عملية لمعالجتها.
تعد فوري أكبر شبكة دفع إلكتروني وأكثرها موثوقية في مصر، حيث تعالج ملايين المعاملات يومياً وتعمل كجسر حيوي بين الاقتصاد الرقمي وقاعدة المستهلكين المصريين التي تعتمد على النقد. بالنسبة لشركات التجارة الإلكترونية والتطبيقات الإلكترونية ومقدمي الخدمات عبر الإنترنت العاملين في السوق المصري، يعد دمج إمكانيات الدفع عبر فوري ضرورة استراتيجية يمكن أن توسع بشكل كبير قاعدة عملائك المستهدفة. يتيح نظام فوري للعملاء إتمام المعاملات عبر قنوات متعددة: مدفوعات الرقم المرجعي في أكثر من 250,000 نقطة بيع في جميع أنحاء مصر بما في ذلك الصيدليات والسوبر ماركت ومحلات الهواتف المحمولة، ومدفوعات المحافظ الإلكترونية عبر تطبيق فوري، والمدفوعات المباشرة بالبطاقات عبر الإنترنت. هذا النهج متعدد القنوات قوي بشكل خاص في مصر حيث لا يزال جزء كبير من السكان لا يمتلكون حسابات بنكية أو يفضلون المعاملات النقدية. من خلال تقديم مدفوعات الرقم المرجعي عبر فوري، يمكن لعملك الوصول إلى العملاء الذين ليس لديهم بطاقات ائتمان أو خصم. تتضمن عملية التكامل ربط موقعك الإلكتروني أو تطبيقك ببوابة الدفع الخاصة بفوري من خلال واجهة برمجة التطبيقات RESTful الموثقة جيداً. يقدم هذا الدليل شرحاً شاملاً لعملية التكامل التقني الكاملة من تسجيل التاجر وإعداد بيانات الاعتماد إلى تنفيذ بدء الدفع ومعالجة عمليات الاسترجاع وإدارة تحديثات حالة المعاملات ومعالجة المبالغ المستردة لتقديم تجربة دفع سلسة تلبي توقعات المستهلك المصري.
يتبع التكامل التقني لبوابة الدفع فوري في موقعك الإلكتروني أو تطبيقك عملية منظمة من خمس خطوات توفر عند تنفيذها بشكل صحيح بنية تحتية قوية وآمنة للدفع لعمليات التجارة الإلكترونية في مصر. الخطوة الأولى هي تسجيل التاجر: يجب عليك التسجيل كتاجر فوري من خلال بوابتهم الرسمية وإكمال وثائق اعرف عميلك المطلوبة التي تشمل السجل التجاري والبطاقة الضريبية وتفاصيل الحساب البنكي للتسوية. عند الموافقة، توفر فوري رمز التاجر الفريد ومفتاح الأمان وبيانات اعتماد واجهة برمجة التطبيقات لبيئتي الاختبار والإنتاج. الخطوة الثانية تتضمن تنفيذ واجهة برمجة تطبيقات بدء الدفع على جانب الخادم حيث يرسل خادمك طلب POST إلى نقطة نهاية واجهة الشحن مع تفاصيل المعاملة والتوقيع الرقمي. الخطوة الثالثة هي إضافة حزمة فوري جافاسكريبت SDK إلى صفحة الدفع التي تعرض نموذج الدفع وتتعامل مع بيانات البطاقة بأمان وفقاً لمعايير PCI DSS. الخطوة الرابعة تتناول إشعارات الاستدعاء وتحديثات الحالة حيث ترسل فوري إشعارات فورية إلى عنوان URL المحدد عند تغير حالة الدفع. يجب على خادمك التحقق من صحة توقيع الاستدعاء وتحديث حالة الطلب وتشغيل المنطق التجاري المناسب. الخطوة الخامسة والأخيرة تغطي معالجة المبالغ المستردة من خلال واجهة برمجة تطبيقات الاسترداد التي تتيح معالجة المبالغ المستردة الكاملة أو الجزئية برمجياً. يضمن تنفيذ معالجة الأخطاء المناسبة والسجلات التفصيلية للمعاملات تجربة دفع موثوقة لعملائك.
يقدم تكامل بوابة الدفع فوري، رغم توثيقه الجيد، عدة تحديات تقنية شائعة يواجهها المطورون بشكل متكرر أثناء التنفيذ. تمثل إخفاقات التحقق من التوقيع المشكلة الأكثر شيوعاً في التكامل. تستخدم فوري توقيعات HMAC-SHA256 للتحقق من سلامة المعاملات ويجب إنشاء التوقيع من خلال ربط حقول محددة بترتيب دقيق محدد في وثائق فوري. تشمل الأخطاء الشائعة ترتيب الحقول غير الصحيح وتضمين المسافات البيضاء واستخدام الترميز الخاطئ. تحقق دائماً من أن إنشاء التوقيع يتبع ترتيب الحقول الدقيق: رمز التاجر ورقم المرجع ومعرف ملف العميل ومبلغ الدفع ومفتاح الأمان. يعد سوء تكوين عنوان URL للاستدعاء مشكلة شائعة أخرى يمكن أن تسبب إخفاقات في مزامنة حالة الدفع. يجب أن تكون نقطة نهاية الاستدعاء متاحة للعامة عبر HTTPS وتستجيب خلال فترة المهلة المحددة وتعيد رمز حالة HTTP 200 المتوقع وتتعامل مع إشعارات الاستدعاء المكررة بشكل متساوي. تحدث أخطاء تنسيق العملة عندما يمرر المطورون قيم المبالغ بدقة عشرية غير صحيحة حيث تتوقع فوري المبالغ بالجنيه المصري بمنزلتين عشريتين بالضبط. تشمل المشكلات الشائعة الإضافية مشاكل ترميز الأحرف مع أسماء العملاء العربية وعدم تطابق المناطق الزمنية. يعد تنفيذ التسجيل الشامل على جانب الخادم الذي يلتقط حمولات الطلب والاستجابة الكاملة أمراً ضرورياً لاستكشاف الأخطاء بسرعة. قم بإعداد المراقبة والتنبيهات الآلية للمعاملات الفاشلة وإنشاء قناة اتصال مباشرة مع فريق الدعم الفني لفوري.
يعد فهم هيكل رسوم فوري والاعتبارات التجارية أمراً بالغ الأهمية لشركات التجارة الإلكترونية المصرية ومقدمي الخدمات عبر الإنترنت للتنبؤ بدقة بتكاليف معالجة المدفوعات وتحسين استراتيجيات التسعير. تفرض فوري رسوماً لكل معاملة تتراوح عادةً بين 1.5% و2.5% من مبلغ المعاملة، مع اختلاف المعدل الدقيق بناءً على عدة عوامل تشمل طريقة الدفع المستخدمة وحجم معاملاتك الشهرية والشروط المحددة المتفاوض عليها. تحمل مدفوعات الرقم المرجعي حيث يدفع العملاء في نقاط بيع فوري مثل الصيدليات والسوبر ماركت رسوم معالجة أقل مقارنة بمدفوعات البطاقات عبر الإنترنت مما يجعلها خياراً فعالاً من حيث التكلفة. تتراوح رسوم مدفوعات البطاقات عبر الإنترنت في النطاق الأعلى بسبب رسوم شبكة البطاقات الإضافية. للتجار ذوي الحجم الكبير، تقدم فوري أسعاراً قابلة للتفاوض يمكن أن تقلل التكاليف بشكل كبير. تعد الجداول الزمنية للتسوية اعتباراً تجارياً حاسماً يؤثر مباشرة على تخطيط التدفق النقدي. تتم معالجة تسويات مدفوعات البطاقات عادةً على أساس T+1 أي أن الأموال تصل في يوم العمل التالي، بينما تتبع تسويات مدفوعات الرقم المرجعي جدولاً زمنياً T+2. فهم هذه الدورات ضروري لإدارة رأس المال العامل خاصة للشركات ذات الهوامش الضيقة. تشمل الاعتبارات الإضافية سياسات رد المبالغ المدفوعة للمعاملات بالبطاقات والحد الأدنى للمعاملات والجداول الزمنية لمعالجة المبالغ المستردة وأدوات التقارير والمطابقة الشهرية المتاحة عبر لوحة تحكم التاجر. بناء هياكل التكلفة هذه في نموذج عملك من البداية يضمن حسابات دقيقة لهامش الربح ونمواً مستداماً لعملياتك.
دعنا نحوّل هذه الأفكار إلى واقع. فريقنا من الخبراء جاهز لمساعدتك على النمو.