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

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

http://Telegram.me/ghasedak

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

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

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

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

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

• CreditCharge
  

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

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

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

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

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

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

  ___________________________________________________

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

  پارامتر خروجی	شرح
  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	کارت شناسایی کارت

  ---

• GetRechargeList
  

  متد تولید لیست تراکنش های سامانه  ( این متد هر ساعت یکبار قابل فراخوانی میباشد و حداکثر تعداد رکورد درخواستی در هر ساعت 800 رکورد میباشد)

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  PageSize	تعداد رکورد درخواستی
  FromDate	از تاریخ
  Price	تا تاریخ

  ___________________________________________________

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

  پارامتر خروجی	شرح
  status	کد نتیجه اجرای متد که در جدول زیر تفکیک شده است
  ActionMessage	تشریح متن فارسی نتیجه اجرا متد
  DTime	تاریخ درخواست
  RechargeList	لیست درخواستی در صورتی که درخواست موفق باشد

  ___________________________________________________

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

  ___________________________________________________

  خروجی	شرح
  TrID	شماره تراکنش
  UserInfo	مشخصات کاربر
  Username	نام کاربری
  TelNumber	شماره تلفن
  SrvTitle	نام سرویس
  iDate	تاریخ ارسال
  Amount	مبلغ
  Result	نتیجه تراکنش
  MethodName	نوع متد فروش
  iTime	زمان ارسال

  ---

• GetStatus
  

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

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

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

  ---

• GetUserCredit
  

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

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

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

  ---

• InquiryCharge
  

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

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

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

  ---

• 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 باید منحصر بفرد و غیر تکراری برای هر تراکنش باشد

  ---

• 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
  

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

  ___________________________________________________

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