اربط مدفوعات شام كاش بتطبيقك.
يحوّل العملاء إلى حسابك في شام كاش. يجلب خادمك الحوالات الواردة عبر واجهتنا البرمجية، ويتحقق منها، ثم يضيف الرصيد إلى العميل المناسب في قاعدة بيانات متجرك. اختر إحدى الطريقتين.
1. التحقق برقم العملية
- اعرض عنوان حسابك في شام كاش والمبلغ المطلوب ضمن صفحة الدفع.
- بعد التحويل، يدخل العميل رقم عملية التحويل في متجرك.
- يجلب عامل واحد مشترك سجل الوارد للحساب المرتبط كل 12 ثانية ويحفظه محلياً. ابحث في السجلات المحلية عن رقم العملية الذي أدخله العميل.
- تحقق من حساب الاستقبال والعملة والمبلغ ووقت التحويل. انسب العملية إلى طلب عميل واحد، ثم سجّل الدفعة وأضف الرصيد ضمن معاملة واحدة في قاعدة البيانات.
2. المطابقة بمرجع فاتورة فريد
- دع العميل يحدد المبلغ. أنشئ فاتورة في قاعدة بياناتك تتضمن العميل والمبلغ والعملة وحساب الاستقبال وموعد انتهاء الصلاحية.
- أنشئ مرجعاً فريداً غير قابل للتخمين بسهولة، مثل SC-7K4M8Q، واطلب من العميل وضعه كما هو في ملاحظة التحويل من تطبيق شام كاش.
- يحفظ عامل الجلب المشترك الحوالات الواردة. طابق مرجع الملاحظة مع الفاتورة، ثم تحقق من المبلغ والعملة والحساب ووقت الدفع.
- حدّث الفاتورة إلى مدفوعة وأضف الرصيد ضمن معاملة ذرية واحدة. لا يحتاج العميل إلى إدخال رقم العملية عندما تكون مطابقة الملاحظة صحيحة.
خمس عمليات جلب في الدقيقة تعني طلباً كل 12 ثانية، مشتركاً بين جميع العملاء للحساب المرتبط نفسه. تتشارك طلبات الأرصدة والوارد حصة الحساب (الحد الافتراضي 6 طلبات في الدقيقة). نسّق جميع عمال الجلب، واحترم استجابات تجاوز الحد، وزد مهلة الانتظار عند حدوث أخطاء.
اجعل مطابقة الدفعات موثوقة
- احتفظ بمفتاح API في خادمك. لا تضعه في كود المتصفح أو ضمن حزمة تطبيق الموبايل.
- افرض قيداً فريداً على (account_id, transaction_id) في قاعدة البيانات. يجب ألا تضيف إعادة المحاولة أو الطلب المكرر أو عاملان متزامنان رصيد الحوالة مرتين.
- استخدم أعداداً عشرية دقيقة أو أصغر وحدة نقدية للحسابات المالية. طابق المبلغ والعملة بدقة، وأرسل الاختلافات للمراجعة.
- أبقِ الطلب قيد الانتظار إذا لم تظهر الحوالة بعد. عدم ظهورها بعد عمليتي جلب لا يثبت فشل الدفع. طبّق مدة صلاحية الفاتورة وسياسة واضحة للدفعات المتأخرة أو المراجعة اليدوية.
- لا تُعِد استخدام مراجع الفواتير. قد تتصادم الأرقام القصيرة، وقد تصل دفعة متأخرة بعد انتهاء الفاتورة.
- اجلب فترة زمنية مناسبة وعالج حدود عدد السجلات أو الصفحات. استأنف من آخر نقطة محفوظة مع تداخل زمني وإزالة التكرار لتجنب فقد الحوالات في الفترات المزدحمة.
- توفّر الواجهة بيانات الحساب. إنشاء الفواتير وإضافة رصيد العملاء والاسترداد ومنطق المطابقة مسؤولية نظام متجرك.