دورة حياة المحفظة

الإنشاء والملكية

تملك المحفظة نوع مالك ومعرف مالك وعملة ونوع محفظة. أنواع المالك تشمل العميل والنشاط والفرع والموظف والنظام. رقم الحساب والمالك لا يمكن تغييرهما بعد الإنشاء. أنشئ محفظة جديدة بدل محاولة نقل ملكية محفظة قائمة.

الحالات

الحالات هي pending_activation وactive وfrozen وsuspended وclosed. الحالة التشغيلية الكاملة هي active. تسمح بعض الحالات المقيدة بالقراءة لكنها تمنع الكتابة. لا تبنِ واجهة العميل على افتراض أن وجود المحفظة يعني إمكانية الدفع.

فهم الرصيد

cached_balance لقطة الرصيد المسجل، وheld_balance مبالغ محجوزة، وpending_balance مبالغ معلقة، وavailable_balance هو المتاح للاستخدام وفق التنفيذ الحالي. استخدم Endpoint الرصيد بدل طرح القيم محليًا إذا تغيّر العقد مستقبلًا.

الحجز والإفراج

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

التجميد وسلامة الدفتر

التجميد وإلغاؤه وverify-integrity عمليات مقيّدة، وليست أدوات عادية لتطبيق العميل. التحقق من سلامة الدفتر قد يكون مكلفًا ويستخدم للتدقيق. التصحيح المالي يتم بالعكس ولا يتم بتعديل القيد الأصلي.