مقدمه

برای شارژ تلفن همراه خود میتوانید از این سرویس شارژ استفاده کنید.

پیش از شروع

  • 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

نمونه postman

سرویس لیست بسته های اینترنتی

شناسه سرویس 47514

با استفاده از این سرویس شما لیست بسته های اینترنتی قابل خرید توسط مشتری را دریافت می کنید و با ارائه productCode در سرویس خرید شارژ بسته اینترنت مورد نظر برای شماره موبایل مورد درخواست شارژ می شود

پارامترهای ورودی

عنوان

اجباری/اختیاری

توضیحات

Page

اجباری

شماره صفحه را مشخص می سازد – مقدار پیش فرض یک می باشد

Size

اجباری

تعداد رکوردی که می خواهید مشاهده کنید را مشخص می سازید – مقدار پیش فرض 100 می باشد

 خروجی

json

 

تعریف پارامترهای خروجی

خروجی این سرویس لیستی از بسته های اینترنتی قابل انتخاب توسط کاربر می باشد

عنوان

توضیحات

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

دیتا-اعتباری

نمونه درخواست

html

نمونه خروجی

به عنوان مثال در خروجی درخواست بالا ،  که بسته های یک ماهه ایرانسل را استخراج میکند.

در ریسپانس، تعداد 30 بسته در نتیجه خروجی آورده شده است که این تعداد را میتوانید در پارامتر count ریسپانس مشاهده کنید.

json

پارامترهای خروجی به صورت زیر می باشند:

شارژ  تلفن همراه

 

Clasor npm package version 2.1.4
به پادیوم قدرت داده اند:
pasargad
fanap
pod