ایران ناتیفیکیشن

تراکنش‌های کیف پول

تاریخچهٔ تراکنش‌های مالی (شارژ، کسر، بازگشت).

GEThttps://api.irnoti.com/v1/wallet/transactions
scope: wallet.read

با page/pageSize صفحه‌بندی می‌شود؛ بدون آن‌ها کل تاریخچهٔ اخیر برمی‌گردد. مبالغ ریال و رشته‌اند، تاریخ‌ها UTC (ISO 8601).

پارامترها

ناممحلنوعتوضیح
pagequeryintegerشمارهٔ صفحه.
pageSizequeryintegerاندازهٔ صفحه.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X GET 'https://api.irnoti.com/v1/wallet/transactions?page=1&pageSize=20' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "items": [
    {
      "id": "5001",
      "type": "debit",
      "amount": "980",
      "createdAt": "2026-10-30T10:20:00.000Z",
      "description": "ارسال پیامک",
      "balanceAfter": "499020"
    }
  ],
  "total": 1
}
تراکنش‌های کیف پول — مستندات API | ایران ناتیفیکیشن