Skip to main content

Get Customer Wallets

تحقّق من الأرصدة النقدية للعملاء عبر العملات المختلفة.

Create Ledger Entry

أضف الأموال إلى محافظ العملاء أو اخصمها منها.

List Ledger Entries

اعرض سجل المعاملات الكامل مع تقسيم الصفحات.

ما هي محافظ العملاء؟

محافظ العملاء هي حسابات أرصدة نقدية تحتفظ بأموال حقيقية لمستخدميك. يحصل كل عميل على محفظة تلقائيًا عند إنشاء حسابه. يمكنك استخدام هذه المحافظ من أجل:
  • تخزين الأموال المدفوعة مسبقًا لدفعات الاشتراك المستقبلية
  • معالجة المبالغ المستردة كرصيد في المحفظة بدلًا من ردّ الأموال إلى البطاقة
  • إصدار أرصدة ترويجية مثل مكافآت الترحيب أو مكافآت الولاء
  • تطبيق أموال المحفظة على الفواتير تلقائيًا أثناء الفوترة
  • تتبّع المعاملات النقدية باستخدام سجل دفتر أستاذ مفصل
يحصل كل عميل تلقائيًا على محفظة عند إنشاء حسابه. تدعم المحافظ عملتي USD وINR، مع أرصدة نقدية منفصلة لكل منهما.
محافظ العملاء ≠ الفوترة القائمة على الائتمانتحتفظ محافظ العملاء بأرصدة نقدية حقيقية (USD وINR) يمكن تطبيقها على الفواتير ودفعات الاشتراكات.إذا كنت تريد تتبّع وحدات الاستخدام الافتراضية (مثل استدعاءات API والرموز وساعات الحوسبة)، فراجع الفوترة القائمة على الائتمان بدلًا من ذلك.
Customer Wallets

آلية العمل

تحتفظ محافظ العملاء بالأموال التي يمكن للعملاء استخدامها في مشترياتهم. عندما تكون لدى العميل فاتورة أو رسوم اشتراك متكررة، يتم التحقق من رصيد محفظته أولًا. وتُطبَّق أي أموال متاحة تلقائيًا على الفاتورة قبل الخصم من طريقة الدفع الأساسية.

الإعداد التلقائي

عند إنشاء عميل جديد، يقوم Dodo Payments تلقائيًا بإنشاء محفظة برصيد صفري. وتصبح المحفظة جاهزة لتلقي الأموال فورًا من خلال API الخاص بنا.

دعم العملات المتعددة

يمكن لكل محفظة الاحتفاظ بأرصدة بعملات مختلفة:
integer
الرصيد بالدولار الأمريكي (مخزّن بالسنتات)
integer
الرصيد بالروبية الهندية (مخزّن بالبَيْسات)
حاليًا، تتوفر أرصدة USD وINR فقط. ستتوفر عملات إضافية قريبًا.

العمل مع المحافظ

التحقّق من أرصدة العملاء

اطّلع على مقدار الأموال التي يملكها العميل عبر جميع العملات. يفيد ذلك في التحقق من الرصيد المتاح قبل معالجة عملية شراء أو عرض الرصيد في واجهة المستخدم الخاصة بتطبيقك.

Get Customer Wallet Balances

تحقّق من الأرصدة النقدية لمحفظة العميل بجميع العملات المدعومة.

إضافة الأموال أو خصمها

موّل محافظ العملاء (مثل مكافآت الترحيب أو أرصدة المبالغ المستردة) أو اخصم الأموال منها (مثل رسوم الاشتراك). يمكنك تقديم أسباب لكل معاملة للحفاظ على مسار تدقيق واضح.
يستخدم الحقل entry_type القيمة 'credit' لإضافة الأموال إلى المحفظة، والقيمة 'debit' لخصم الأموال من المحفظة.

Create Customer Wallet Ledger Entry

أضف الأموال إلى محفظة العميل أو اخصمها منها.

عرض سجل المعاملات

اطّلع على كل معاملات الإضافة والخصم الخاصة بالعميل. يساعدك دفتر الأستاذ المفصل هذا في تسوية الحسابات، ويوفر الشفافية لعملائك.

List Customer Wallet Ledger Entries

اعرض كل معاملة نقدية للعميل.

أمثلة من الواقع

ردّ المبلغ إلى المحفظة

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

مكافأة ترحيبية / رصيد ترويجي

قدّم للعملاء الجدد مكافأة ترحيبية نقدية لتشجيعهم على إجراء أول عملية شراء.

دفع الاشتراك من المحفظة

اخصم الأموال من المحفظة لتغطية رسوم اشتراك أو عملية شراء يدوية.

نظام الفوترة المدفوعة مسبقًا

اسمح للعملاء بتمويل حساباتهم مقدمًا والسحب من ذلك الرصيد بمرور الوقت.
1

Add Initial Funds

أضف الأموال إلى محفظة العميل عند إجراء إيداع.
2

Apply Balance to Purchases

اخصم من الرصيد عندما يستخدم العميل خدماتك أو يجدّد اشتراكاته.
3

Monitor Balances

تحقّق مما إذا كان العملاء يوشكون على نفاد الأموال لإرسال مطالبة بإعادة التعبئة.

دعم العملات المتعددة

أدر أرصدة نقدية منفصلة للعملاء في المناطق المختلفة.
أدر أموال USD للعملاء المقيمين في الولايات المتحدة.
أدر أموال INR للعملاء الهنود.

أفضل الممارسات

منع المعاملات المكررة

استخدم مفاتيح idempotency لضمان عدم إضافة الأموال أو خصمها مرتين عن طريق الخطأ للحدث نفسه.

التحقق من الأرصدة قبل الخصم

تحقّق من امتلاك العملاء أموالًا كافية قبل محاولة معالجة معاملات كبيرة من المحفظة.

ما التالي؟

هذه الميزات مخطط لإصدارات مستقبلية:
  • انتهاء صلاحية الرصيد: حدّد مدة تنتهي بعدها صلاحية الأموال
  • تحليلات أفضل: تقارير مفصلة عن الإنفاق واتجاهات الرصيد
  • Webhooks إضافية: إشعارات فورية بتغيّرات الرصيد والتنبيهات عند انخفاضه
ابدأ بعمليات التمويل والخصم الأساسية، ثم ادمج تدفقات عمل الفوترة الآلية الأكثر تعقيدًا مع نمو نشاطك التجاري.
آخر تعديل في ٣١ يوليو ٢٠٢٦