ChargeService
وب سرویس قاصدک
برای اطلاعات بیشتر از طریق کانال تلگرام به آدرس زیر در ارتباط باشید
http://Telegram.me/ghasedak
جدول کد های بازگشتی توابع وب سرویس
کد ارسالی | شرح کد |
0 | تراکنش با موفقیت اجرا گردید |
1 | نام کاربری یا کلمه عبور معتبر نمیباشد |
2 | مبلغ ارسالی معتبر نیست |
3 | شماره همراه ارسالی معتبر نیست |
4 | سرویس مورد نظر در دسترسی نمی باشد |
5 | اعتبار کاربر کمتر از مبلغ از ارسالی است |
6 | کاربر مورد نظر وجود ندارد و یا غیر فعال است |
7 | کد سفارش ارسالی نا معتبر می باشد |
8 | تراکنش مورد نظر وجود ندارد |
9 | تراکنش در دست انجام می باشد |
10 | ترکنش با خطا مواجه گردید |
11 | اجرای درخواست با خطا مواجه گردید |
12 | کد سفارش ارسالی تکراری است |
13 | کد واریزی صحیح نمیباشد |
متناسب با درخواست خود می توانید از متداها زیر استفاده نمایید
توجه فرمایید خروجی تمام متدها یک رشته با فرمت جیسون و یکسان می باشد
شرح پارامترهای خروجی متدها در جدول زیر توضیح داده شده است
پارامتر خروجی | شرح |
ResultCode | کد نتیجه اجرای متد که در جدول بالا تفکیک شده است |
Note | تشریخ فارسی نتیجه اجرا متد |
TransactionID | کد رهگیری تراکنش |
Amount | مبلغ تراکنش |
MobileNumber | شماره همراه |
TransactionTime | زمان انجام تراکنش |
Creadit | مانده اعتبار کاربر |
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 لینک صفحه پرداخت
- GetAvailableCardCountList
- GetAvailableCardList
-
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 کد سفارش باید یک مقدار منحصر بفرد ارسال گردد
ShopName نام فروشگاه
خروجی متد مطابق لیست شرح داده شده در ابتدای صفحه می باشد
در نظر داشته باشید شارژ شورانگیز رایتل برای مبالغ 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 کد سفارش باید یک مقدار منحصر بفرد ارسال گردد
ShopName نام فروشگاه
خروجی متد مطابق لیست شرح داده شده در ابتدای صفحه می باشد
در نظر داشته باشید شارژ شورانگیز رایتل برای مبالغ 20000 و50000 و100000 و200000و500000و1000000 ریالی در نظر گرفته شده است و سایر مبالغ معتبر نمیباشد و با خطا مواجه خواهد شد
-
getPinAvailableList
این متد لیست پین های فعال و قابل ارائه در سامانه را برمیگرداند
___________________________________________________
خروجی متد با فرمت جیسون می باشد