وب سرویس توزیع شارژ الکترونیکی - توشانت 

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

http://Telegram.me/toshanet

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

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

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

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

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

• BillGetInfo
  

  برای استعلام پرداخت قبض از این متد استفاده نمایید

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  BillID	شناسه قبض
  PayID	شناسه پرداخت

  ___________________________________________________

  خروجی متد شامل موارد زیر میباشد

  پارامتر خروجی	شرح
  BillID	شناسه قبض
  PayID	شناسه پرداخت
  Price	مبلغ
  TypeID	کد نوع قبض
  Type	نوع قبض
  Status	کد نتیجه عملیات پرداخت قبض
  StatusMessage	شرح کد نتیجه عملیات پرداخت قبض

  ---

• BillInquiry
  

  برای استعلام  قبض از این متد استفاده نمایید

  پارامتر ورودی	شرح
  UserName	نام کاربری وب رویس
  Password	رمز ورود
  BillId	شناسه قبض
  PayId	شناسه پرداخت

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

  ---

• BulkBillPaymentWS
  

  برای پرداخت قبض گروهی از این متد استفاده میشود توجه داشته باشید حداکثر تعداد قبض های ارسالی در هر بار بیش از 20 عدد نباشد.

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

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  ReturnUrl	لینک بازگشت نتیجه متد
  BatchBillRequestDataItem	لیستی رشته ای از نوع جیسون شامل شناسه قبض و شناسه پرداخت و کد سفارش مشتری

  ___________________________________________________

  BatchBillRequestDataItem شامل موارد ورودی زیر میباشد

  پارامتر ورودی	شرح
  BillID	شناسه قبض
  PayID	شناسه پرداخت
  ExtOrderID	کد سفارش مشتری

  ___________________________________________________

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

  پارامتر خروجی	شرح
  BatchBillPaymentResponseDataItems	وضعیت اولیه قبض ها در سامانه
  Status	کد نتیجه
  StatusMessage	شرح کد نتیجه فراخوانی این متد
  BatchToken	کد توکن گروهی یا کد پیگیری گروهی که به ازاء فراخوانی این متد ایجاد میگردد
  TotalAmount	مجموع کل قبوض وارده شده
  PaymentUrl	لینک پرداخت برای این متد نتیجه نهایی بعد از اجرای این متد به لینکی در ایتدای توضیحات این متد آورده شد برگشت داده میشود

  ___________________________________________________

  BatchBillPaymentResponseDataItems شامل موارد خروجی زیر میباشد

  پارامتر خروجی	شرح
  BillID	شناسه قبض
  PayID	شناسه پرداخت
  Status	وضعیت
  StatusMessage	شرح کد وضعیت
  Price	مبلغ قبض
  BillType	نوع قبض
  BillTypeCode	کد نوع قبض
  ExtOrderID	کد سفارش مشتری

  ___________________________________________________

  نمونه ReturnUrl

  http://yourdomain?BatchTokenID={0}&Status={1}&StatusDescription={2}&BillItems={3}

  ---

  ___________________________________________________

  پارامتر خروجی	شرح
  BatchTokenID	کد پیگیری گروهی دریافتی در مرحله قبل
  Status	وضعیت عملیات پرداخت
  StatusDescription	شرح کد عملیات پرداخت
  BillItems	لیست قبض ها ی ارسالی

  ___________________________________________________

  BillItems شامل خروجی های زیر میباشد

  ---

  پارامتر خروجی	شرح
  Amount	مبلغ قبض
  BillID	شناسه قبض
  PayID	شناسه پرداخت
  billTypeID	کد نوع قبض
  billTypeName	نوع قبض
  ExtOrderID	کد سفارش مشتری
  SaleReferenceID	SaleReferenceID
  Sataus	کد نتیجه
  SatausDescription	شرح کد نتیجه
  Token	کد پیگیری قبض

  ---

• BulkRecharge
  

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

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

  ___________________________________________________

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

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

  ___________________________________________________

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

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

  ___________________________________________________

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

  ---

• ChargeGetPaymentLink
  

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

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  MobileNumber	شماره تلفنی که میخواهید عملیات شارژ بر روی آن انجام گیرد
  ServiceId	نوع سرویس را مشخص میکند که به ترتیب 1 شارژ مستقیم و 5 برای ارسال بسته استفاده میشود 1- شارژ اعتباری 2- شارژ دایمی 4- وایمکس 5- بسته اینترنتی
  Amount	مبلغ شارژ یا بسته
  Params	مشحض کننده پارامتر سرویس میباشد که اگر اپراتور ایرانسل باشد 4 به معنی شگفت انگیز . برای شارژ معمولی عدد صفر، برای اپراتور رایتل 3 به معنی شور انگیز میباشد و برای ارسال بسته کد بسته در این فسمت برای تمامی اپراتورها قرار میگیرد
  RetUrl	نتیجه بازگشت از بانک در این متغییر بر میگردد همچنین شما در این متغببر نتیجه ارسال شارژ را نیز دریافت مینمایید در آخر توضیحات نمونه آورده شده است
  ExtOrderID	کد سفارش باید یک مقدار منحصر بفرد ارسال گردد

  ___________________________________________________

  خروجی متد شامل موارد زیر میباشد

  پارامتر خروجی	شرح
  ResultCode	کد عملیات
  ResultCaption	شرح کد عملیات
  Url	لینک پرداخت بانک

  ___________________________________________________

  نتیجه پرداخت در متغیر RetUrl برمیگردد که شرح آن در زیر آورده شده است

  پارامتر خروجی	شرح
  PaymentReference	کد پیگیری پرداخت
  TransactionReference	کد پیگیری شارژ
  PaymentResult	کد نتیجه پرداخت بانک
  PaymentResultMsg	شرح کد نتیجه پرداخت بانک

  نمونه RetUrl

  http://yourdomain?PaymentReference={0}&TransactionReference={1}&PaymentResult={2}&PaymentResultMsg={3}

  ---

• CheckOperator
  

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

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  PhoneNO	شماره تلفن همراه
  Provider	1| 2| 3

  در صورتی کهProvider :

  1| ایرانسل
  2|همراه اول
  3|رایتل
  

  ___________________________________________________

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

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

  ___________________________________________________

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

  ---

• CreditCharge
  

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

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

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

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

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

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

  ___________________________________________________

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

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

   

  ---

• GetAvailableCardCountList
• GetAvailableCardList
• GetAvalibleLCardCountList
  

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

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

  ___________________________________________________

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

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

  ___________________________________________________

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

  ---

• GetAvalibleLCardList
  

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

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

   

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

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

  ---

• GetBillPhoneInfo
  

  این متد در قالب رشته نتیجه استعلام شماره تلفن همراه و یا تلفن ثابت را نمایش میدهد.

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  PhoneNO	شماره تلفن همراه / تلفن ثابت
  BillType	MCI OR TCI

  در صورتی که شماره ارسالی:

  TCI| تلفن ثابت
  MCI|تلفن همراه
  

  ___________________________________________________

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

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

  ___________________________________________________

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

  ___________________________________________________

  فرمت جیسون Result

  نام	شرح
  BillId	شناسه قبض
  PayId	شناسه پرداخت
  Amount	مبلغ قابل پرداخت
  Status	نتیجه
  Message	پیغام ارسالی از سمت صادر کننده

  _____________________________________________

  MidTermBillInfo قبض میان دوره 
  |LastTermBillInfo قبض پابان دوره
  

  ---

• GetInternetPackages
  

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

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

  
  

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

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

  ---

• GetLastRechargeList
  

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

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

   

  نوع درخواست شامل موارد زیر میباشد WServiceUser یا WinUser

  ___________________________________________________

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

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

  ___________________________________________________

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

  ___________________________________________________

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

  ---

• 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	کارت شناسایی کارت

  ---

• GetOfferInternetPackages
• 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	رمز ورود

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

  ---

• 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	کد تراکنش ارسالی کاربر

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

  ---

• IsPrepaidMobilePhone
  

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

  پارامتر ورودی	شرح
  Username	نام کاربری وب سرویس
  Password	کلمه عبور
  PhoneNO	شماره تلفن همراه
  Provider	1| 2| 3

  در صورتی کهProvider :

  1| ایرانسل
  2|همراه اول
  3|رایتل
  

  ___________________________________________________

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

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

  ___________________________________________________

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

  ---

• OfferRecharge
• 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	مبلغ قابل پرداخت قبض و یا آدرس برگشت نمیتواند خالی باشد

  ---

• PaymentInquery
  

  برای استعلام پرداخت از این متد استفاده نمایید

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

  ___________________________________________________

  خروجی متد شامل موارد زیر میباشد

  پارامتر خروجی	شرح
  PayID	کد پیگیری
  ResultMsg	شرح کد عملیات
  ResCode	کد عملیات در صورتی که صفر دریافت نماید عملیات موفق بوده
  Price	مبلغ ارسالی
  iDate	تاریخ ارسال
  iTime	زمان ارسال
  BankName	نام بانکی که عملیات پرداخت در آن صورت گرفته است

  ---

• 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	کد سفارش باید یک مقدار منحصر بفرد ارسال گردد
  ShopName	نام فروشگاه

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

  در نظر داشته باشید شارژ شورانگیز رایتل برای مبالغ 20000 و50000 و100000 و200000و500000و1000000 ریالی در نظر گرفته شده است و سایر مبالغ معتبر نمیباشد و با خطا مواجه خواهد شد
  در نظر داشته باشید شارژ شگفت انگیز ایرانسل برای مبالغ،10000،20000،50000،100000،200000 ریالی در نظر گرفته شده است و سایر مبالغ معتبر نمیباشد و با خطا مواجه خواهد شد
  در نظر داشته باشید شارژ همراه اول فقط برای مبالغ 21000،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	کد سفارش باید یک مقدار منحصر بفرد ارسال گردد
  ShopName	نام فروشگاه

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

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

  ---

• getPinAvailableList
  

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

  ___________________________________________________

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