واجهة برمجية للأموال عبر الهاتف مع بيئة اختبار حقيقية

طلب الدفع وصفحة الدفع والروابط والتحويلات والفواتير والاسترداد. يقبل كل طلب مفتاح عدم تكرار، فلا تدفع إعادة المحاولة مرتين. والإشعارات موقّعة بنافذة زمنية، والتكرار لا يضر.

مكتبات من ملف واحد لـ Node.js وPython وPHP تتولى تجديد الرموز وإعادة المحاولة الآمنة وفحص الإشعارات. وهي بلا تبعيات، فلا شيء للتدقيق أو الترقيع، ويمكن نسخها إلى استضافة مشتركة.

تعرض بوابة المطورين الحركة اليومية وأهم نقاط الوصول وصحة الإشعارات وطريقك إلى التشغيل. وتغطي الإضافات المتاجر الشائعة، وفي التوثيق مثال لكل مهمة.

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

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

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