GET /v2/wallet/balance

Route Info

شرح عملکرد (Functionality)

این متد وظیفه محاسبه تراز کیف پول (Wallet) را بر عهده دارد. بر اساس کدهای فعلی، این متد صرفاً موجودی کیف پول شعبه (ERP) را محاسبه می‌کند.

پارامترهای ورودی (Query String)

?type=office       // (بلااستفاده) به دلیل باگ داخلی نادیده گرفته می‌شود
&id=101            // (اختیاری) شناسه شعبه. اگر ارسال نشود از توکن کاربر خوانده می‌شود

خروجی (Response)

موفقیت (Success):

ساختار خروجی استاندارد شامل payload (داده اصلی) و meta (اطلاعات متا) است.

{
    "payload": {
        "credit": 15000000,       // مجموع ورودی‌ها
        "debit": 5000000,         // مجموع خروجی‌ها
        "balance": 10000000,      // مانده (credit - debit)
        "diagnosis": "creditor"   // وضعیت: creditor | debtor | neutral
    },
    "meta": {
        "timestamp": 1715780000
    }
}

خطا (Error):

{
    "status": false,
    "time": 1715780005,
    "message": "Error message here...",
    "trace": [...]
}