ملی ای‌پی‌آی

قبض رایتل را کجا ببینم؟ سه راه و تفاوت‌شان

قبض رایتل را در اپلیکیشن اپراتور، با کد دستوری و از راه وب‌سرویس می‌توان دید؛ سومی برای محصولی است که باید برای دیگران استعلام بگیرد.

قبض رایتل را در سه جا می‌شود دید و هر سه یک چیز را نشان نمی‌دهند: اپلیکیشن اپراتور، کد دستوری و استعلام از راه وب‌سرویس. تفاوت‌شان در این است که هرکدام چه اطلاعاتی کنار مبلغ می‌دهند.

اگر فقط می‌خواهید بدهی خودتان را بدانید، اپلیکیشن کافی است. اگر برای دیگران استعلام می‌گیرید، مثلاً در یک سامانهٔ پرداخت، دو مسئله پیش می‌آید که مقاله‌های عمومی کمتر دربارهٔ آن حرف می‌زنند: خط دائمی یا اعتباری بودن، و اینکه دو مبلغ می‌بینید.

سه راه دیدن قبض

اپلیکیشن اپراتور. منابع عمومی می‌گویند در منوی صورتحساب اپلیکیشن «رایتل من» می‌شود قبض را دید و پرداخت کرد. این راه دقیق‌ترین است چون مستقیم از خود اپراتور می‌آید، ولی شما باید با همان شماره وارد شده باشید و برای خط شخص دیگر کاربردی ندارد.

کد دستوری. برخی منابع کد *200# را برای باز کردن منوی پرداخت قبض معرفی می‌کنند. کدهای دستوری با گذر زمان و بازطراحی منوها عوض می‌شوند و منابع هم با هم هم‌خوان نیستند. پیش از اتکا، کد را از اپلیکیشن یا پشتیبانی اپراتور وارد کنید.

وب‌سرویس. برای کسی که می‌خواهد در محصول خودش بگذارد، وب‌سرویس استعلام قبض رایتل با شمارهٔ موبایل کار می‌کند و مبلغ و شناسه‌ها را در قالب JSON می‌دهد. نیازی به ورود با رمز کاربر نیست؛ برای همین هم می‌تواند برای خطوط سازمانی دیگران استفاده شود (البته با مبنای قانونی خودتان برای پرسیدن آن شماره).

وقتی سایت اپراتور «وضعیت سیم‌کارت» را نشان می‌دهد، قبض نیست

یک دام ساده: صفحهٔ «استعلام وضعیت سیم‌کارت» در سایت اپراتور با کد ملی، شماره و کد امنیتی کار می‌کند. این برای فهمیدن فعال یا مسدود بودن خط است و مبلغ قبض را مستقیماً نشان نمی‌دهد. اگر کسی از شما می‌پرسد «چرا قبضم نیامد»، اول مطمئن شوید همین دو را قاطی نکرده است.

یک خط ممکن است به دلیل پرداخت‌نکردن قبض مسدود شود و این در منابع عمومی از دلایل رایج مسدودی ذکر شده، ولی دلیل مسدودی را باید از اپراتور پرسید. استعلام قبض جواب این سؤال را نمی‌دهد.

چرا دو مبلغ می‌بینید

پاسخ برای خط دائمی دو بلوک دارد:

  • final_term: پایان‌دوره، قبضی که دورهٔ آن بسته شده.
  • mid_term: میان‌دوره، حساب جاری تا این لحظه.

هرکدام مبلغ، شناسهٔ قبض و شناسهٔ پرداخت خودشان را دارند. منطق دقیق‌تر این دو و اینکه کدام را بپردازید، در راهنمای میان‌دوره و پایان‌دورهٔ همراه اول آمده و برای رایتل هم شکل پاسخ همان است. من اینجا تکرارش نمی‌کنم.

فقط یک نکتهٔ عملی بیفزایم: وقتی پایان‌دوره صفر است و میان‌دوره مبلغ دارد، خط بدهی سررسیدشده ندارد ولی مصرف جدید در راه است. اگر پیام «بدهکار نیستید» نشان بدهید و دو روز بعد کاربر قبض ببیند، اعتمادش را از دست می‌دهید.

خط اعتباری قبض ندارد

رایتل هم مثل دو اپراتور دیگر برای خط اعتباری صورتحساب دوره‌ای صادر نمی‌کند. استعلام قبض برای چنین خطی نتیجهٔ معنادار نمی‌دهد. پاسخ بدون مبلغ لزوماً به معنای «همه‌چیز پرداخت شده» نیست.

اگر نمی‌دانید خط دائمی است یا اعتباری، از خود کاربر بپرسید. من در رابط‌هایی که طراحی می‌کنم یک گزینهٔ ساده می‌گذارم: «دائمی (قبض ماهانه)» یا «اعتباری (شارژ)». دو ثانیه از وقت کاربر می‌گیرد و یک فراخوان بی‌نتیجه را حذف می‌کند.

اگر شماره را از اپراتور دیگری منتقل کرده باشید

شماره ممکن است بین اپراتورها منتقل شده باشد. در این حالت پیش‌شماره دیگر نشان نمی‌دهد خط مال کدام اپراتور است. اگر مطمئن نیستید (و می‌خواهید قبض رایتل را با API بگیرید)، سه فراخوان موازی نزنید؛ از کاربر بپرسید اپراتورش کدام است. این در بخش پیاده‌سازی مقالهٔ طراحی لایهٔ قبوض موبایل هم آمده است.

آنچه این استعلام نمی‌کند

  • مصرف، ریز تماس‌ها و بسته‌های فعال را نمی‌دهد.
  • وضعیت مسدودی یا فعال بودن خط را نمی‌گوید.
  • پرداخت انجام نمی‌دهد؛ فقط شناسه‌هایی می‌دهد که به درگاه پرداخت بدهید.
  • نشان نمی‌دهد خط به نام چه کسی است.

کدام راه برای کدام کاربر

اگر مخاطب شما فردی است که قبض خودش را می‌خواهد، اپلیکیشن کافی است و نیازی به API نیست. اگر شما یک سامانه یا اپلیکیشن مالی دارید که باید برای کاربرانش استعلام بگیرد، وب‌سرویس تنها راه عملی است، چون نمی‌شود از کاربر خواست وارد اپلیکیشن دیگری شود و عدد را کپی کند.

در سمت دیگر، اگر مخاطب شما یک شرکت با خطوط رایتل کارکنان است، ترکیب هر دو بهتر است: اپلیکیشن یا پنل سازمانی برای ریز مصرف، و وب‌سرویس برای دیدن بدهی همه در یک جدول.

پرسش‌هایی که پیش از تماس با پشتیبانی بپرسید

  • شماره را درست وارد کرده‌ام؟ استعلام فقط شماره را می‌گیرد و رقم اشتباه نتیجهٔ بی‌ربط می‌دهد.
  • خط دائمی است؟
  • کدام بخش، پایان‌دوره یا میان‌دوره، مبلغ دارد؟
  • پرداخت اخیر با شناسهٔ پرداخت همان بخش انجام شده؟

این چهار پرسش بیشتر موارد «قبضم را نمی‌بینم» را پیش از تماس با پشتیبانی حل می‌کند.

یک سناریوی فرضی

تصور کنید کاربری می‌گوید سیم‌کارتش قطع شده و فکر می‌کند قبض پرداخت نکرده. شما استعلام می‌گیرید و هر دو مبلغ صفر است. این یعنی قبضی برای پرداخت وجود ندارد، پس دلیل قطعی را جای دیگر بپرسید: وضعیت سیم‌کارت یا پشتیبانی اپراتور. بسیار مهم است که پاسخ استعلام را به «خط مسدود نیست» ترجمه نکنید. استعلام آن را نمی‌گوید.

چه اطلاعاتی را از کاربر نخواهید

برای استعلام قبض به کد ملی یا رمز نیاز نیست؛ ورودی فقط شمارهٔ موبایل است. بنابراین از کاربر چیز بیشتری نپرسید. فرمی که کد ملی هم بخواهد، بی‌دلیل کاربر را می‌ترساند و نرخ تکمیل را پایین می‌آورد. هرچه کمتر بپرسید، کمتر باید نگه دارید و محافظت کنید.

اگر شماره را ذخیره می‌کنید، در لاگ‌ها آن را پوشانده بنویسید. شمارهٔ کامل فقط جایی لازم است که خود کاربر می‌خواهد چشمی با شمارهٔ خودش مقایسه کند.

پرسش‌های متداول

قبض رایتل را بدون اپلیکیشن می‌شود دید؟ با کد دستوری یا وب‌سرویس بله، ولی کدها را از منبع روز تأیید کنید.

چرا دو مبلغ دارم؟ چون پایان‌دوره و میان‌دوره دو چیز جدا هستند و هرکدام شناسهٔ پرداخت خودش را دارد.

خط اعتباری هم قبض دارد؟ نه، صورتحساب دوره‌ای فقط برای خط دائمی صادر می‌شود.

استعلام می‌گوید بدهی ندارم، ولی خطم قطع است. چرا؟ قطع بودن خط دلایل دیگری هم دارد و استعلام قبض آن‌ها را نشان نمی‌دهد. وضعیت سیم‌کارت را جداگانه بررسی کنید.

خلاصه برای مرور بعدی

برای بدهی خودتان اپلیکیشن، برای وضعیت سیم‌کارت صفحهٔ اپراتور، و برای ساختن محصول وب‌سرویس. دو مبلغ را دو چیز مستقل بدانید، خط اعتباری را از اول جدا کنید و به شمارهٔ منتقل‌شده شک کنید. مشخصات ورودی و خروجی در مستندات API است.

آخرین بازبینی: تیم تحریریه ملی ای‌پی‌آی

وب‌سرویس مرتبط با این راهنما

API استعلام قبض رایتل

صورتحساب خط دائمی رایتل.

مشاهده مشخصات فنی و تعرفه

راهنماهای مرتبط

پرسش و تجربه کاربران

اگر این راهنما جوابتان را نداد، همین‌جا بپرسید. پرسش‌ها را تیمملی ای‌پی‌آی پاسخ می‌دهد و هر نظر پیش از انتشار بررسی می‌شود.

هنوز پرسشی ثبت نشده، اولین نفر باشید.