شارژ تلفن همراه
خدمتدهنده
پرداخت الکترونیک پاسارگاد
مقدمه
برای شارژ تلفن همراه خود میتوانید از این سرویس شارژ استفاده کنید.
پیش از شروع
- URL فراخوانی سرویسها:
Production Server: https://api.pod.ir/srv/sc/nzh/doServiceCall
Sandbox Server:https://sandbox.pod.ir/srv/sc/nzh/doServiceCall
- تمامی درخواستها با متد POST ارسال میشوند.
- فیلدهای زیر درHeader تمامی درخواستها ثابت است:
پارامتر | توضیحات |
_token_ | توکن کسبوکاری دریافتی از پنل |
_token_issuer_ | مقدار ثابت "1" |
- فیلدهای زیر در بدنهی تمامی درخواستها ثابت است (با فرمت x-www-form-urlencoded):
پارامتر | توضیحات |
scProductId | شناسه ی سرویس مدنظر |
scApiKey | راهنمای دریافت این پارامتر در این لینک موجود است. |
- علاوه بر موارد بالا که ثابت هستند، اگر سرویس نیاز به پارامتر دیگری داشته باشد در داکیومنت مربوطه ذکر شده است.
- خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.
نکته:پس از درخواست سرویس به پادیوم، همکاران ما درخواستهای ارسالی را بررسی میکنند. در صورت عدم دریافت تایید کرد بر روی درخواست ارسالی ظرف یک روز کاری،به همکاران ما از طریق شماره تلفن (021-89518989) و یا در گروه واتساپ اطلاع دهید تا دسترسی به سرویس موردنظر برای شما فعال شود.
دریافت توکن
-
شناسه سرویس: 47512
- پارامترهای ورودی: ندارد.
- پارامترهای خروجی:
خروجی این سرویس یک json با ساختار زیر است:
توضیحات | پارامتر |
---|---|
نوع توکن | token_type |
توکن | access_token |
توکن دریافتی از این سرویس را در header هر درخواست در پارامتر Authorization به صورت زیر ارسال کنید:
Authorization: token_type access_token
مثال:
Authorization: Bearer ejvhfgcbncj...
توجه: این توکن تا 5 ساعت معتبر است.
خرید شارژ
-
شناسه سرویس: 47513
-
پارامترهای ورودی
نام پارامتر | نوع | اختیاری/اجباری | توضیحات |
---|---|---|---|
mobileNumber | String | اجباری | شماره موبایل |
productCode | String | اجباری | (با توجه به جدول بعد)کد کالا |
amount | string | اجباری | مبلغ تراکنش به ریال |
- مقادیر productCode
نوع شارژ | کد |
---|---|
ایرانسل عادی | 93 |
ایرانسل شگفت انگیز | 97 |
همراه اول | 95 |
رایتل عادی | 94 |
رایتل شگفت انگیز | 96 |
نمونه پاسخ برگشتی
بعد از فراخوانی وب سرویس ، خروجی دریافتی از وب سرویس به صورت یک JSON به شکل زیر خواهد بود .در صورتی که تراکنش موفق باشد مقدار 0=responseCode و Success=responseMessage خواهد بود وtransactionId حاوی مقداری خواهد بود که از سمت اپراتور ارسال شده است، در غیر اینصورت خطایی رخ داده که لیست خطاها به شرح زیر آورده می شود و مقدارnull =transactionId خواهد بود.
{
"invoiceId":"",
"responseCode":"",
"responseMessage":"",
"transactionId":"",
"otherParams":null
}
نمونه postman
سرویس لیست بسته های اینترنتی
شناسه سرویس 47514
با استفاده از این سرویس شما لیست بسته های اینترنتی قابل خرید توسط مشتری را دریافت می کنید و با ارائه productCode در سرویس خرید شارژ بسته اینترنت مورد نظر برای شماره موبایل مورد درخواست شارژ می شود
پارامترهای ورودی
عنوان | اجباری/اختیاری | توضیحات |
Page | اجباری | شماره صفحه را مشخص می سازد – مقدار پیش فرض یک می باشد |
Size | اجباری | تعداد رکوردی که می خواهید مشاهده کنید را مشخص می سازید – مقدار پیش فرض 100 می باشد |
خروجی
تعریف پارامترهای خروجی
خروجی این سرویس لیستی از بسته های اینترنتی قابل انتخاب توسط کاربر می باشد
عنوان | توضیحات |
Id | Id بسته |
operatorCode | کد اپراتور |
operatorName | نام اپراتور |
productCode | کد محصول |
packageTimeCode | کد دوره بسته |
packageTime | دوره بسته (روزانه، شبانه) |
duration | مدت اعتبار |
traffic | ترافیک بسته |
nightTraffic | ترافیک شبانه |
callNetwork | مکالمه درون شبکه برای اپراتور |
price | قیمت بسته |
priceWithTax | قیمت با ارزش افزوده |
simType | نوع سیم کارت (1 = دائمی، 2 = اعتباری) |
simTypeDesc | نام نوع سیم کارت (دائمی، اعتباری) |
description | شرح کامل بسته |
responseDate | زمان پاسخ |
sellRate | رتبه فروش |
otherParams | پارامترهای اضافه |
giftTraffic | حجم ترافیک هدیه |
با ارسال productCode در سرویس خرید شارژ (شماره سرویس 47513) امکان فعالسازی بسته اینترنتی برای مشتری امکان پذیر می باشد
جستجوی بسته اینترنت
(شناسه سرویس 2739661)
این سرویس جهت جستجو و دسته بندی لیست بسته های اینترنتی ، سرویس دهنده شاپ است .
پارامتر ورودی:
نام پارامتر | اختیاری/اجباری | توضیحات |
operatorName | اجباری | نام اپراتور |
duration | اجباری | بسته های ساعتی ، روزانه ، هفتگی ، ماهانه و ... مربوط به هریک از اپراتور ها را استخراج کنید. |
simCardType | اختیاری | جستجو را براساس سیمکارتهای دائمی ، اعتباری، دیتا و ... انجام دهید . |
که با استفاده از productCode در خروجی برای هر بسته ، میتوانید در سرویس خرید شارژ و بسته ی سرویس دهنده ی شاپ ، از آن استفاده نموده و بسته خود را خریداری نمایید .
مقادیر قابل استفاده در پارامتر operatorName :
MTN | ایرانسل |
MCI | همراه اول |
RIGHTEL | رایتل |
MCI-JIRING":" | همراه اول – کیف پول جیرینگ |
MOEIN | معین |
SHATEL | شاتل |
TALIA | تالیا |
FANAP-MOBILE | فناپ موبایل |
APTEL | آپتل |
مقادیر قابل استفاده در پارامتر duration :
HOURLY | بسته های ساعتی |
1-DAY | بسته های یک روزه |
3-DAY | بسته های سه روزه |
7-DAY | بسته های هفتگی |
15-DAY | بسته های پانزده روزه |
1-MONTH | بسته های یک ماهه |
2-MONTH | بسته های دو ماهه |
3-MONTH | بسته های سه ماهه |
4-MONTH | بسته های چهار ماهه |
6-MONTH | بسته های شش ماهه |
1-YEAR | بسته های یک ساله |
مقادیر قابل استفاده در پارامتر simCardType :
مقدار ورودی | نوع سیمکارت |
PERMANENT | دائمی |
PREPAID | اعتباری |
PERMANENT_PREPAID | دائمی-اعتباری |
DATA_PERMANENT | دیتا-دائمی |
DATA_PREPAID | دیتا-اعتباری |
نمونه درخواست
نمونه خروجی
به عنوان مثال در خروجی درخواست بالا ، که بسته های یک ماهه ایرانسل را استخراج میکند.
در ریسپانس، تعداد 30 بسته در نتیجه خروجی آورده شده است که این تعداد را میتوانید در پارامتر count ریسپانس مشاهده کنید.
پارامترهای خروجی به صورت زیر می باشند: