وضعیت کیف پول سازمانی کارمند (Get)

مقدار باقی مانده کیف پول هر کارمند را نشان میدهد در صورتی که محدودیتی هم برای کارمند تعریف شده باشد آن را نشان میدهد.

---

اطلاعات عمومی

• آدرس: /api/v3/wallet/status
• متد: POST
• نوع محتوا: application/json
• احراز هویت: نیازمند token

---

پارامترهای درخواست

فیلد	نوع داده	ضروری	توضیحات
PassengerID	integer	بله	شناسه مسافر
RidePrice	integer	بله	مبلغ کرایه سفر به ریال

---

نمونه درخواست

curl --location 'https://corporate.snapp.site/api/v3/wallet/status' \
  -H 'Authorization:  <your_authorization_token>' \
  -H 'Content-Type: application/json' \
  --data '{
      "PassengerID": 1234,
      "RidePrice": 1234
  }'

---

پاسخ موفق

{
  "data": {
    "balance_status": 1,
    "has_budget_restriction": true,
    "remaining_balance": 0
  },
  "message": "string",
  "status": 0
}

فیلد	نوع داده	توضیحات
data	object	شامل وضعیت کیف پول
balance_status	integer	وضعیت موجودی کیف پول (۰: ناکافی، ۱: کافی)
has_budget_restriction	boolean	آیا محدودیت بودجه وجود دارد یا خیر
remaining_balance	integer	مانده حساب مسافر به ریال
message	string	پیام موفقیت یا خطا
status	integer	کد وضعیت پاسخ

---

کدهای وضعیت و خطاها

کد وضعیت	توضیحات
0	درخواست موفق بود
400	درخواست نامعتبر
401	نیاز به احراز هویت
403	دسترسی غیرمجاز
500	خطای داخلی سرور