GET /v2/wallet/transactions

Route Info

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

این متد برای دریافت لیست تراکنش‌های کیف پول استفاده می‌شود و داده‌ها را پس از پردازش سنگین (شامل joinهای متعدد، تبدیل داده‌ها، تعیین subject/object/operator، لینک‌دهی رزرو و فاکتور، و ساخت ساختار نهایی) برمی‌گرداند.

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

Query Params

?branch=101

Body Params (paginate)

{
  "paginate": {
    "start": 0,
    "length": 20
  }
}

خروجی (Response)

موفق (Success)

{
  "items": [
    {
      "id": 10023,
      "subject": "خرید از هاب توسط دفتر ایکس",
      "object": "دفتر ایکس (1023)",
      "credit": 500000,
      "debit": 0,
      "description": "متن توضیحات | رفرنس ...",
      "operator": {
          "id": 4,
          "text": "1234 - علی رضایی",
          "query": { ... }
      },
      "service": "دفتر سرویس",
      "sub_service": "دفتر زیرسرویس",
      "details": { ... },
      "confirm_at": "2024-06-15 12:11:05",
      "confirm_note": null,
      "confirm_by": { ... }
    }
  ],
  "meta": {
    "timestamp": 1715780023,
    "table": {
      "total": 200,
      "per_page": 20,
      "current_page": 1,
      "last_page": 10,
      "from": 1,
      "to": 20
    }
  }
}

خطا (Error)

در صورت بروز Exception (مثلاً موارد زیر):

{
  "error": {
    "code": 500,
    "message": "Exception message...",
    "trace": [ ... ]
  }
}

`