الفكرة في سطرين

قبل ما تربط payment gateway، حدّد الفلوس هتروح لمين، وإمتى الحجز يبقى confirmed، والرسوم والـrefunds هيتحسبوا إزاي، والنظام هيعمل إيه لو تأكيد الدفع اتأخر أو اتكرر.

الدفع في marketplace غالبًا مش مجرد عميل بيدفع سعر. ممكن يكون فيه مقدم خدمة، وعمولة للمنصة، ورسوم للـgateway، ورصيد في wallet، وحجز ينفع يتقبل أو يترفض أو يتلغي.

لو القرارات دي مش واضحة، إننا ننادي على الـAPI أسرع مش هيخلّي حركة الفلوس صح.

كل جزء من الفلوس هيروح لمين؟

نكتب حركة الفلوس قبل ما نصمم الـendpoints. عمولة المنصة هتتضاف على سعر مقدم الخدمة ولا هتتخصم منه؟ مين هيتحمل رسوم المعاملة؟ وإمتى الرصيد يبقى متاح للسحب؟

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

إمتى الحجز يبقى confirmed فعلًا؟

حالة الدفع وحالة الحجز مش نفس الحاجة. الـgateway ممكن يأكد إن الفلوس اتدفعت، ومقدم الخدمة لسه ماقبلش الحجز. لازم نقرر هل ده مسموح، والعميل هيشوف إيه في الوقت ده.

  • مقدم الخدمة بيوافق قبل الدفع ولا بعده؟
  • لو رفض أو لغى، إيه اللي يحصل؟
  • وقت الـrefund، أنهي رسوم بترجع؟
  • لو الحجز بين بلدين، أنهي عملة وgateway هنستخدم؟

لو تأكيد الدفع اتأخر أو اتكرر؟

مسار التعافي لازم يتصمم مع مسار الدفع الناجح. تأكيد اتبعت مرتين ماينفعش يضيف مستحقات مقدم الخدمة مرتين. ودفع نجح عند الـgateway بس ما اتسجلش عندنا لازم نقدر نكتشفه بالـreconciliation.

التنفيذ محتاج يتحقق من تأكيد الـgateway، ويخلّي تحديث حالة المعاملة آمن لو اتكرر. التفاصيل بتختلف حسب مقدم الخدمة؛ قرار المنتج الأساسي هو إمتى نعتبر المعاملة مؤكدة، وإزاي نصلّح أي اختلاف بين النظامين.

نجهز إيه قبل ما نبدأ التنفيذ؟

رسم بسيط للحالات، ومثال لحساب الرسوم، ومثال للـrefund، وقائمة بحالات الفشل. الحاجات دي أحيانًا أهم من إننا نبدأ بالـSDK، لأنها هتحدد شكل الداتا والـwallet والـAPIs والرسائل اللي العميل هيشوفها.

قواعد البزنس ← حركة الفلوس ← حالات الفشل ← reconciliation ← ربط الـgateway.

الـAI ممكن يساعد في تنفيذ flow واضح. بس مسؤولية المهندس لسه إنه يفهم أنهي flow البزنس محتاجه.