Get Customer Wallets
تحقّق من الأرصدة النقدية للعملاء عبر العملات المختلفة.
Create Ledger Entry
أضف الأموال إلى محافظ العملاء أو اخصمها منها.
List Ledger Entries
اعرض سجل المعاملات الكامل مع تقسيم الصفحات.
ما هي محافظ العملاء؟
محافظ العملاء هي حسابات أرصدة نقدية تحتفظ بأموال حقيقية لمستخدميك. يحصل كل عميل على محفظة تلقائيًا عند إنشاء حسابه. يمكنك استخدام هذه المحافظ من أجل:- تخزين الأموال المدفوعة مسبقًا لدفعات الاشتراك المستقبلية
- معالجة المبالغ المستردة كرصيد في المحفظة بدلًا من ردّ الأموال إلى البطاقة
- إصدار أرصدة ترويجية مثل مكافآت الترحيب أو مكافآت الولاء
- تطبيق أموال المحفظة على الفواتير تلقائيًا أثناء الفوترة
- تتبّع المعاملات النقدية باستخدام سجل دفتر أستاذ مفصل
يحصل كل عميل تلقائيًا على محفظة عند إنشاء حسابه. تدعم المحافظ عملتي USD وINR، مع أرصدة نقدية منفصلة لكل منهما.

آلية العمل
تحتفظ محافظ العملاء بالأموال التي يمكن للعملاء استخدامها في مشترياتهم. عندما تكون لدى العميل فاتورة أو رسوم اشتراك متكررة، يتم التحقق من رصيد محفظته أولًا. وتُطبَّق أي أموال متاحة تلقائيًا على الفاتورة قبل الخصم من طريقة الدفع الأساسية.الإعداد التلقائي
عند إنشاء عميل جديد، يقوم 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
تحقّق مما إذا كان العملاء يوشكون على نفاد الأموال لإرسال مطالبة بإعادة التعبئة.
دعم العملات المتعددة
أدر أرصدة نقدية منفصلة للعملاء في المناطق المختلفة.US Customers
US Customers
أدر أموال USD للعملاء المقيمين في الولايات المتحدة.
Indian Customers
Indian Customers
أدر أموال INR للعملاء الهنود.
أفضل الممارسات
منع المعاملات المكررة
استخدم مفاتيح idempotency لضمان عدم إضافة الأموال أو خصمها مرتين عن طريق الخطأ للحدث نفسه.التحقق من الأرصدة قبل الخصم
تحقّق من امتلاك العملاء أموالًا كافية قبل محاولة معالجة معاملات كبيرة من المحفظة.ما التالي؟
- انتهاء صلاحية الرصيد: حدّد مدة تنتهي بعدها صلاحية الأموال
- تحليلات أفضل: تقارير مفصلة عن الإنفاق واتجاهات الرصيد
- Webhooks إضافية: إشعارات فورية بتغيّرات الرصيد والتنبيهات عند انخفاضه