API استعلام قبض ایرانسل
با شمارهٔ موبایل یک خط دائمی ایرانسل، دو صورتحساب پایاندوره و میاندوره را با مبلغ و شناسه‌های قبض و پرداخت برمی‌گرداند.
این سرویس چه می‌کند
اپلیکیشنی که خط کاربر را از شماره می‌شناسد، باید اول بداند کدام اپراتور است و بعد فراخوان درست را بزند. اینجا همان‌جاست که سرویس ایرانسل معنا پیدا می‌کند: یک مسیر مستقل با ورودی ساده، شمارهٔ موبایل، و خروجی دوبخشی.
پیش‌شماره‌هایی که معمولاً به ایرانسل نسبت داده می‌شوند ۰۹۳ و ۰۹۰ هستند، اما پیششماره تنها نشانهٔ احتمالی است و تضمین نمی‌کند اپراتور فعلی همان باشد. اگر برنامه‌تان جدول پیششماره دارد، جای تصمیم قطعی از آن فقط برای پیش‌فرض استفاده کنید و به کاربر اجازه بدهید اپراتور را عوض کند.
مسیر‌یابی بین سه اپراتور
یک جدول ساده بنویسید: پیششماره، اپراتور پیش‌فرض، و گزینهٔ تغییر دستی. اگر پاسخ بینتیجه آمد، به کاربر نگویید قبض ندارد؛ بگویید «شاید اپراتور دیگری انتخاب شود» و دو گزینهٔ دیگر را پیشنهاد کنید.
پاسخ دوبخشی
هر بخش مبلغ، شناسهٔ قبض و شناسهٔ پرداخت مستقل دارد. پایاندوره دورهٔ بسته است و میاندوره از آن تا امروز را نشان میدهد. در رابط، دو کارت جدا نشان دهید تا کاربر به‌اشتباه هر دو را پرداخت نکند.
آنچه این سرویس نمی‌کند
سیمکارت اعتباری را پوشش نمی‌دهد، چون صورتحساب دورهای ندارد. پرداخت نمی‌کند، کارکرد مکالمه و بستهٔ اینترنت را نمی‌دهد و مالک خط را معرفی نمی‌کند. شمارهٔ فاقد قالب معتبر موبایل پیش از رسیدن به مرجع رد میشود و هزینهای ندارد.
هزینهٔ فراخوان در حالت‌های لبه
فراخوانی که پاسخ معتبر بگیرد هزینه دارد، حتی اگر پاسخ «بدهی‌ای نیست» یا «قبضی پیدا نشد» باشد. چون سرویس مرجع واقعاً پرسیده شده و جواب داده است. در مقابل، شمارهٔ بدقواره که پیش از رسیدن به سرویس مرجع ردّ شود، یا لحظه‌ای که سرویس مرجع در دسترس نباشد، هزینهای ندارد. اگر این دو را در منطق برنامه‌تان از هم جدا کنید، شمارش هزینه‌ها با گزارش مصرف پنل یکی درمی‌آید.
کجا به کار می‌آید
- سوپراپلیکیشن با تشخیص اپراتور از پیش‌شمارهپس از ورود شماره، اپراتور حدس زده میشود و کاربر می‌تواند انتخاب را عوض کند تا استعلام نادرست نشود.
- شرکت‌های توزیع و پخش با خطوط ایرانسل ویزیتورهابدهی خط هر ویزیتور پایان هر دوره خوانده و در محاسبهٔ هزینهٔ ماه ثبت میشود.
- فروشگاه‌های سیمکارت و خدمات موبایلمشتری حضوری شمارهٔ خود را میدهد و فروشنده بدهی را پیش از فروش بسته یا ارتقا نشان میدهد.
ورودی و خروجی
ورودی
mobilestringشمارهٔ موبایلیازده رقم که با 09 شروع میشود.نمونهٔ بدنهٔ درخواست
{
"mobile": "09120000000"
}خروجی
final_termobjectmid_termobjectقیمت و شرط پرداخت
قیمت هر فراخوان API استعلام قبض ایرانسل ۵۰۰ تومان است.
| تعداد استعلام در ماه | قیمت هر استعلام |
|---|---|
| همهٔ فراخوان‌ها | ۵۰۰ تومان |
آخرین تغییر قیمت:
مبلغ پیش از تماس با سرویس مرجع از موجودی پنل قفل میشود و اگر پاسخی نیاید، آزاد میشود. ورودی نامعتبر، در دسترس نبودن سرویس مرجع و عبور از سقف نرخ هزینهای ندارند. «رکوردی یافت نشد» یک پاسخ معتبر است و هزینه دارد.
کمترین مبلغ شارژ پنل: ۵۰۰٬۰۰۰ تومان
پرسش‌های متداول
قبض ایرانسل را چطور با شماره موبایل استعلام کنیم؟
شمارهٔ موبایل خط دائمی را بفرستید. پاسخ دو بخش پایاندوره و میاندوره دارد که هرکدام مبلغ و شناسهٔ قبض و شناسهٔ پرداخت میدهند.
آیا ایرانسل من برای استعلام لازم است؟
برای استفاده از این سرویس نیازی به ورود به اپ اپراتور نیست؛ فقط شمارهٔ موبایل لازم است.
سیمکارت اعتباری ایرانسل قبض دارد؟
خیر، صورتحساب دورهای ندارد و استعلامش بینتیجه میماند. سرویس مخصوص خط دائمی است.
تفاوت میاندوره و پایاندوره ایرانسل چیست؟
پایاندوره صورتحساب دورهٔ بستهشده است. میاندوره مصرف از آن تاریخ تا لحظهٔ استعلام را نشان میدهد.
پیششماره ۰۹۳ همیشه یعنی ایرانسل؟
نه لزوماً. پیششماره نشانهٔ احتمالی است. اگر خط بین اپراتورها منتقل شده باشد، فقط اپراتور فعلی تعیینکننده است.
اگر شمارهٔ اپراتور دیگر را بفرستیم چه میشود؟
از مخزن نمیتوان نتیجه را تضمین کرد. اگر پاسخ بینتیجه آمد، اپراتور دیگر را امتحان کنید.
چرا بعد از پرداخت هنوز مبلغ نمایش داده میشود؟
بهروزرسانی ثبت پرداخت تأخیر دارد. رسید را نگه دارید و چند ساعت بعد دوباره بپرسید.
آیا شمارهٔ فارسینویسشده پذیرفته میشود؟
بله. رقم فارسی، +۹۸ و ۰۰۹۸ به قالب یازدهرقمی با ۰۹ یکدست میشود.
هزینهٔ استعلام برای شمارهٔ نامعتبر کسر میشود؟
خیر. شمارهای که قالب معتبر موبایل نداشته باشد پیش از ارسال به مرجع رد میشود و هزینهای ندارد.