وب سرویس قاصدک 

برای اطلاعات بیشتر از طریق کانال تلگرام به آدرس زیر در ارتباط باشید

http://Telegram.me/ghasedak

جدول کد های بازگشتی توابع وب سرویس

متناسب با درخواست خود می توانید از متداها زیر استفاده نمایید

توجه فرمایید خروجی تمام متدها یک رشته با فرمت جیسون و یکسان می باشد

شرح پارامترهای خروجی متدها در جدول زیر توضیح داده شده است

The following operations are supported. For a formal definition, please review the Service Description.

• BulkRecharge
  

  این متد برای ارسال شارژ گروهی استفاده میشود

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  BulkRequest	در قالب جیسون لیست درخواست ارسال گروهی شارژ با بسته اینترنتی یا هردو

  ___________________________________________________

  ورودی متد با فرمت جیسون به شرح زیر می  باشد

  پارامتر ورودی	شرح
  RowID	شماره ردیف که باید از 1 سروع شود
  PID	کد اپراتور به ترتیب 1 ایرانسل ،2 همراه اول ،3 رایتل میباشد
  Amount	مبلغ شارژ یا بسته
  TelNumber	شماره تلفن
  ServiceId	نوع سرویس را مشخص میکند که به ترتیب 1 شارژ مستقیم و 5 برای ارسال بسته استفاده میشود
  ServiceParam	مشحض کننده پارامتر سرویس میباشد که اگر اپراتور ایرانسل باشد 4 به معنی شگفت انگیز . برای شارژ معمولی عدد صفر، برای اپراتور رایتل 3 به معنی شور انگیز میباشد و برای ارسال بسته کد بسته در این فسمت برای تمامی اپراتورها قرار میگیرد
  ExtOrderID	کد منحصر بفرد که از سمت شما برای سامانه ارسال میشود  این کد برای پیگیری ها مورد استفاده قرار میگیرد

  ___________________________________________________

  نتیجه بعد از فراخوانی متد شامل جدول زیر میباشد

  نام	شرح
  ResultCode	کد نتیجه
  BulkID	کد پیگیری شارژ گروهی
  BulkRequestCount	تعداد دریافتی شارژ های گروهی

  ___________________________________________________

  در نظر داشته باشید شما در هر بار ارسال شارژ گروهی فقط میتوانید به تعداد 200 شارژ یک جا ارسال نمایید

  ---

• CreditCharge
  

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

  توجه داشته باشید در صورت اجرای موفق این متد لینک صفحه پرداخت ارایه می گردد که افزایش اعتبار پنل منوط به تکمیل روال پرداخت است

  لینک پرداخت حداکثر 10 دقیقه معتبر بوده و یکبار مصرف می باشد

  پارامتر ورودی	شرح
  Username	نام کاربری  وب سرویس
  Password	کلمه عبور
  Amount	مبلغ
  CallBackURL	آدرس بازگشت از صفحه پرداخت

  توجه داشته باشید از اعلایم {0} و {1} و {2} در لینک بازگشتی میتوانید جهت دریافت کد پیگیری و نتیجه تراکنش پرداخت و کد نتیجه پرداخت استفاده نمایید

  برای مثال  http://yourdomain/paymant/{0}/{1}/{2}

  ___________________________________________________

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

  پارامتر خروجی	شرح
  Status	کد نتیجه اجرای متد که در جدول بالا تفکیک شده است
  Note	تشریخ فارسی نتیجه اجرا متد
  URL	لینک صفحه پرداخت

   

  ---

• GetAvalibleLCardCountList
  

  این متد لیست تعداد پین های مشاهده نشده شما را نمایش میدهد

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور

  ___________________________________________________

  خروجی متد با فرمت جیسون به شرح زیر می  باشد

  پارامتر خروجی	شرح
  ResultCode	کد نتیجه اجرای متد که در جدول زیر تفکیک شده است
  Message	تشریخ فارسی نتیجه اجرا متد
  CardCountList	لیست بازگشتی تعداد پین های مشاهده نشده به تفکیک اپراتور و قیمت

  ___________________________________________________

  خروجی	شرح
  0	عملیات موفق
  1	نام کاربری و کلمه عبور را وارد نمائید
  2	نام کاربری وارد شده یافت نشد
  3	خطای سیستمی روی داده است

  ---

• GetAvalibleLCardList
  

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

  پارامتر ورودی	شرح
  Username	نام کاربری  وب سرویس
  Password	کلمه عبور

   

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

  پارامتر خروجی	شرح
  PID	کد اپرانور
  ProviderTitle	نام اپراتور
  SID	کد کارت شارژ
  ServiceName	نام کارت شارژ
  UnitPrice	قیمت کارت شارژ

  ---

• GetInternetPackages
  

  برای دریافت لیست بسته های اینترنتی هر یک از اپراتورها از این متد استفاده کنید

  پارامتر ورودی	شرح
  OperatorID	شماره اپراتور مورد نظر 1- ایرانسل 2- همرا اول 3- رایتل

  
  

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

  پارامتر خروجی	شرح
  ServiceID	کد بسته اینترنتی
  ProviderTitle	نام اپراتور
  ServiceName	مشخصات بسته
  ServicePrice	قیمت بسته
  ProfileName	نوع بسته

  ---

• GetLastTransactions
  

  این متد لیست حداکثر 5 تراکنش آخر کاربر را بر میگرداند

  توجه داشته باشید حداکثر 5 رکورد آخر و حداقل یک رکورد را میتوانید درخواست نمایید در صورتی که پارامتری ارسال نشود 5 رکورد آخر نمایش داده خواهد شد
  

  پارامتر ورودی	شرح
  Username	نام کاربری  وب سرویس
  Password	کلمه عبور
  Phonenumber	شماره تلفن استعلامی
  Status	وضعیت : 0 موفق | 1 ناموفق |2 هردو
  RowCount	حداکثر 5 رکورد | تعداد رکورد درخواستی

   

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

  پارامتر خروجی	شرح
  Status	وضعیت درخواست
  Result	لیست درخواست از تراکنش ها

  در صورتی که مقدار وضعیت درخواست برابر صفر باشد عملیات با موفقیت انجام گرفته و لیست درخواستی مقدار دارد در غیر اینصورت خطائی صورت گرفته لیست خطا به شرح زیر میباشد
  

  Status	شرح
  1	نام کاربری یا کلمه عبور معتبر نمی باشد
  10	تراکنش با خطا مواجه گردید

  ---

• GetNewCard
  

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

  توجه داشته باشید وضعیت پین ارسالی به حالت مصرف شده تغییر می یابد و بعد از ارسال دیگر قابل دریافت از طریق این متد نمی باشد

  پارامتر ورودی	شرح
  Username	نام کاربری  وب سرویس
  Password	کلمه عبور
  Pid	کد اپراتور
  Amount	مبلغ

   

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

  پارامتر خروجی	شرح
  PID	کد اپراتور
  PinID	کد پیگیری پین
  Amount	قیمت کارت
  PinCode	رمز کارت شارژ
  SerialNumber	سریال کارت شارژ
  ServiceName	نام کارت شارژ
  SID	کارت شناسایی کارت

  ---

• GetStatus
  

  برای دریافت وضعیت سرویس دهی اپراتورها از این متد نمایید
  
  

  خروجی اجرای متد یک جدول شامل دو فیلد به شرح زیر می باشد
  

  عنوان	توضیحات
  ServiceName	نام اپراتورها به ترتیب ایرانسل همراه اول رایتل بانک
  ServiceStatus	وضعیت سرویس دهی اپراتور فعال برابر با یک غیر فعال برابر با صفر

  ---

• GetUserCredit
  

  جهت دریافت باقی مانده اعتبار کاربر ار این متد استفاده کنید

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	رمز ورود

  خروجی متد مطابق لیست شرح داده شده در ابتدای صفحه  می  باشد
  
  

  ---

• InquiryBulkCharge
  

  این متد در قالب لیست نتیجه شارژ های گروهی را نمایش میدهد.

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  BulkID	کد برگشتی از متد  BulkRecharge

  ___________________________________________________

  خروجی متد با فرمت جیسون به شرح زیر می  باشد

  پارامتر خروجی	شرح
  ResultCode	کد نتیجه اجرای متد که در جدول زیر تفکیک شده است
  BulkResultList	نتیجه به ازاء هر تراکنش ::: فرمت خروجی شرح داده شده جیسون میباشد

  ___________________________________________________

  خروجی	شرح
  0	عملیات موفق
  1	نام کاربری و کلمه عبور را وارد نمائید
  2	نام کاربری وارد شده یافت نشد
  3	خطای سیستمی روی داده است

  ___________________________________________________

  فرمت جیسون BulkResultList

  نام	شرح
  TransactionsId	کد تراکنش
  ResultCode	کد نتیجه
  ResultCodeText	شرح کد نتیجه
  Amount	مبلغ ارسالی
  TelNumber	شماره تلفن ارسالی
  TransactionsDate	تاریخ ثبت تراکنش
  TransactionsTime	زمان ثبت تراکنش
  ExtOrderID	کد سفارش مشتری

  _____________________________________________

  در صورتی که در کد نتیجه 9 را دریافت نمایید یعنی تراکنش فعلا در حال انجام است و نتیجه فطعی دریافت نشده است برای دریافت نتیجه فطعی لطفا مجددا متد را فراخوانی نمایید.

  ---

• InquiryCharge
  

  برای استعلام شارژ ارسالی از این متد استفاده نمایید

  پارامتر ورودی	شرح
  UserName	نام کاربری وب سرویس
  Password	رمز ورود
  TransactionID	کد رهگیری تراکنش

  خروجی متد مطابق لیست شرح داده شده در ابتدای صفحه  می  باشد
  
  

  ---

• InquiryChargeByExtOrderID
  

  برای استعلام درخواست ارسالی از طریق شماره پیگیری خود از این متد استفاده نمایید

  پارامتر ورودی	شرح
  UserName	نام کاربری وب سرویس
  Password	رمز ورود
  ExtOrderID	کد تراکنش ارسالی کاربر

  خروجی متد مطابق لیست شرح داده شده در ابتدای صفحه  می  باشد
  
  

  ---

• OperatorIdentification
  

  متد بر اساس شماره ورودی اپراتور را تشخیص میدهد

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  MobileNumber	شماره موبایل

  ___________________________________________________

  خروجی متد با فرمت جیسون به شرح زیر می  باشد

  پارامتر خروجی	شرح
  status	کد نتیجه اجرای متد که در جدول زیر تفکیک شده است
  ActionMessage	تشریح متن فارسی نتیجه اجرا متد
  OperatorName	نام اپراتور
  OperatorID	آی دی اپراتور

  ___________________________________________________

  خروجی	شرح
  0	عملیات موفق و اپراتور معرفی شده است
  1	نام کاربری و کلمه عبور را وارد نمائید
  2	نام کاربری وارد شده یافت نشد
  3	خطای سیستمی روی داده است

  ---

• PayBills
  

  متد تولید لینک پرداخت قبوض
  

  توجه داشته باشید در صورت اجرای موفق این متد لینک صفحه پرداخت ارایه می گردد که پرداخت قبض منوط به تکمیل روال پرداخت است

  لینک پرداخت حداکثر 10 دقیقه معتبر بوده و یکبار مصرف می باشد

  پارامتر ورودی	شرح
  UserName	نام کاربری  وب سرویس
  Password	کلمه عبور
  BillID	شناسه قبض
  BillPayID	شناسه پرداخت
  Price	مبلغ
  ReturnUrl	آدرس برگشت از بانک

  ___________________________________________________

  خروجی متد با فرمت جیسون به شرح زیر می  باشد

  پارامتر خروجی	شرح
  ResultCode	کد نتیجه اجرای متد که در جدول زیر تفکیک شده است
  ResultCaption	تشریخ فارسی نتیجه اجرا متد
  BillType	نوع قبض
  Url	لینک صفحه پرداخت

  ___________________________________________________

  خروجی	شرح
  0	عملیات موفق و ایجاد لینک پرداخت
  1	نام کاربری یا کلمه عبور معتبر نمی باشد
  2	مبلغ ارسالی معتبر نیست
  3	خطای سیستمی
  100	شناسه قبض و پرداخت، همخوانی ندارد
  101	شناسه قبض و پرداخت، اشتباه است
  102	شناسه قبض اشتباه است
  103	شناسه پرداخت اشتباه است
  104	خطای شناسایی نشده
  105	نام کاربری و کلمه عبور را وارد نمائید
  106	شناسه قبض یا پرداخت نمیتواند خالی باشد
  107	مبلغ قابل پرداخت قبض و یا آدرس برگشت نمیتواند خالی باشد

  ---

• PinPurchase
  

  این متد یک از سامانه خرید نموده و تحویل کاربر میدهد

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  PID	نوع اپراتور
  Amount	مبلغ پین درخواستی

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

  ___________________________________________________

  خروجی متد با فرمت جیسون به شرح زیر می  باشد

  پارامتر خروجی	شرح
  status	کد نتیجه اجرای متد که در جدول زیر تفکیک شده است
  Message	تشریح متن فارسی نتیجه اجرا متد
  Result	نتیجه عمیلیات که به صورت جیسون میباشد
  PanelAds	تبلیغات فروشگاه شما
  MarketName	نام فروشگاه شما

  ___________________________________________________

  خروجی	شرح
  0	عملیات موفق و اپراتور معرفی شده است
  1	نام کاربری و کلمه عبور را وارد نمائید
  2	نام کاربری وارد شده یافت نشد
  3	خطای سیستمی روی داده است

  ---

• Recharge
  

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

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	رمز ورود
  MobileNumber	شماره همراه
  Amount	مبلغ شارژ
  Service	سرویس مورد نظر 1- شارژ اعتباری 2- شارژ دایمی 4- وایمکس 5- بسته اینترنتی
  Params	کد بسته اینترنتی و یا برای ارسال شگفت انگیز در ایرانسل 4 و در رایتل 3 و در غیر اینصورت 0 ارسال گردد
  UserOrderID	کد سفارش باید یک مقدار منحصر بفرد ارسال گردد

  خروجی متد مطابق لیست شرح داده شده در ابتدای صفحه می باشد
  

  در نظر داشته باشید شارژ شورانگیز رایتل برای مبالغ 20000 و50000 و100000 و200000و500000و1000000 ریالی در نظر گرفته شده است و سایر مبالغ معتبر نمیباشد و با خطا مواجه خواهد شد
  در نظر داشته باشید شارژ شگفت انگیز ایرانسل برای مبالغ 10000،20000،50000،100000،200000 ریالی در نظر گرفته شده است و سایر مبالغ معتبر نمیباشد و با خطا مواجه خواهد شد
  در نظر داشته باشید شارژ همراه اول فقط برای مبالغ 10000،20000،50000،100000،200000 ریالی در نظر گرفته شده است و سایر مبالغ معتبر نمیباشد و با خطا مواجه خواهد شد
  UserOrderID باید منحصر بفرد و غیر تکراری برای هر تراکنش باشد

  در نظر داشته باشید گرفتن کد تراکنش به همراه کد وضعیت صفر به منزله ارسال موفق شارژ نیست و پس از دریافت کد تراکنش باید یکی از دو متد زیر را جهت استعلام وضعیت ارسال شارژ فراخوانی نمایید

  1- InquiryCharge

  2- InquiryChargeByExtOrderID

  ---

• RechargeMNP
  

  برای ارسال مستقیم شارژ به شماره های ترابرد شده از این متد نمایید

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	رمز ورود
  MobileNumber	شماره همراه
  Provider	کد اپراتور 1- ایرانسل 2-همراه اول 3- رایتل
  Amount	مبلغ شارژ
  Service	سرویس مورد نظر 1- شارژ اعتباری 2- شارژ دایمی 4- وایمکس 5- بسته اینترنتی
  Params	کد بسته اینترنتی و یا برای ارسال شگفت انگیز در ایرانسل 4 و در رایتل 3 و در غیر اینصورت 0 ارسال گردد
  UserOrderID	کد سفارش باید یک مقدار منحصر بفرد ارسال گردد

  خروجی متد مطابق لیست شرح داده شده در ابتدای صفحه  می  باشد
   

  در نظر داشته باشید شارژ شورانگیز رایتل برای مبالغ 20000 و50000 و100000 و200000و500000و1000000 ریالی در نظر گرفته شده است و سایر مبالغ معتبر نمیباشد و با خطا مواجه خواهد شد

  ---

• getPinAvailableList
  

  این متد لیست پین های فعال  و قابل ارائه در سامانه را برمیگرداند

  ___________________________________________________

  خروجی متد با فرمت جیسون می  باشد