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

نحوه استفاده از وب سرویس پرداخت آینکس در این مطلب، آموزش داده می شود. در این وب سرویس امکان استفاده از تمام زبان های برنامه نویسی فراهم می باشد

 

 

آدرس وب سرویس :

تمامی درخواست ها باید به آدرس زیر ارسال شود

https://inax.ir/webservice.php

 

شرح متدها :

از متدهای زیر جهت ارتباط با وب سرویس استفاده می گردد.

 

نام متد توضیح
credit استعلام موجودی حساب
products دریافت قیمت و لیست محصولات (کارت شارژ پین – گیفت کارت – بسته اینترنت – آنتی ویروس و …)
charge خرید شارژ مستقیم – شارژ شگفت انگیز – شارژ وایمکس
check_bill استعلام مبلغ و نوع قبض
pay_bill پرداخت قبض
buy_product خرید محصول
  • مقادیر ورودی باید از طریق پروتکل POST به سرور آینکس ارسال شود.
  • خروجی تمامی متد ها به صورت JSON تولید می گردد.

متد استعلام موجودی نماینده credit :

با استفاده از این متد می توانید موجودی حساب را استعلام نمائید

 

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

نام پارامتر مثال ضروریت توضیح
action credit اجباری نام متد
username 123 اجباری نام کاربری وب سرویس
password 321 اجباری پسورد وب سرویس

 

مقادیر بازگشتی متد credit :

نام پارامتر مثال توضیح
res_code 1 در صورت موفق بودن عدد 1 در غیر این صورت مطابق جدول کدهای خطا
credit 1200 موجودی نماینده به تومان

 

متد دریافت لیست محصولات products :

منظور از محصولات در اینجا کارت شارژ پین، بسته اینترنت، گیفت کارت، آنتی ویروس و … است.

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

 

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

نام پارامتر مثال ضروریت توضیح
action products اجباری نام متد
username 123 اجباری نام کاربری وب سرویس
password 321 اجباری پسورد وب سرویس

 

 

مقادیر بازگشتی متد products :

نام پارامتر مثال توضیح
res_code 1 در صورت موفق بودن عدد 1 در غیر این صورت مطابق جدول کدهای خطا
products لیست کل محصولات موجود به صورت json

هر محصول دارای id ، name , amount می باشد.

مبلغ محصولات به تومان ذکر شده است.

 

متد خرید شارژ charge :

توسط این متد می توانید کارت شارژ مستقیم و شگفت انگیز و وایمکس خریداری نمائید.

 

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

نام پارامتر مثال ضروریت توضیح
action charge اجباری نام متد
username 123 اجباری نام کاربری وب سرویس
password 321 اجباری پسورد وب سرویس
operator MTN اجباری MTN : شارژ معمولی ایرانسل
MTN! : شارژ شگفت انگیز ایرانسل
MTN# : شارژ خط دائمی ایرانسل
WiMax : شارژ وایمکس ایرانسل
MCI : شارژ همراه اول
RTL : شارژ رایتل
RTL! : شارژ شورانگیز رایتل
amount 2000 اجباری برای اپراتورهای ایرانسل و رایتل مبلغ شارژ از 500 تومان تا 50,000 تومان پذیرفته می شود .
برای اپراتور همراه اول مبالغ 1,000 ، 2,000 ، 5,000 ، 10,000 ، 20,000 تومان قابل قبول است.
mobile 09123456789 اجباری شماره تلفن همراهی که قصد شارژش را دارید
order_id 2350 اجباری شماره تراکنش در سایت شما (باید منحصر به فرد باشد)
company آینکس اجباری نام نمایشی در پیامک ارسالی پس از شارژ ایرانسل

 

 

مقادیر بازگشتی متد charge :
در صورتی که پارامترهای ورودی معتبر باشد مقدار res_code برابر 1 خواهد بود. در غیر این صورت مقدار res_code برابر با کد خطایی خواهد بود که در جدول کدهای خطا نمایش داده شده است

نام پارامتر مثال توضیح
res_code 1 در صورت موفق بودن عدد 1 در غیر این صورت مطابق جدول کدهای خطا
ref_code 553544544 رسید تراکنش

 

متد بررسی مبلغ و نوع قبض check_bill :

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

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

نام پارامتر مثال ضروریت توضیح
action check_bill اجباری نام متد
username 123 اجباری نام کاربری وب سرویس
password 321 اجباری پسورد وب سرویس
bill_id 12345678910 اجباری شناسه قبض
pay_id 326541 اجباری شناسه پرداخت

 

 

مقادیر بازگشتی متد check_bill :
در صورتی که شناسه پرداخت و شناسه قبض معتبر باشد مقدار res_code برابر 1 خواهد بود. در غیر این صورت مقدار res_code برابر با کد خطایی خواهد بود که در جدول کدهای خطا نمایش داده شده است

نام پارامتر مثال توضیح
res_code 1 در صورت موفق بودن عدد 1 در غیر این صورت مطابق جدول کدهای خطا
bill_type water نوع قبض

این فیلد عددی به صورت زیر بیانگر شرکت خدماتی قبض است:
1: آب – water،
2: برق – power،
3: گاز – gas،
4: تلفن ثابت – phone،
5: تلفن همراه – mobile،
6: عوارض شهرداری – taxes

amount 14500 مبلغ (تومان)

 

متد پرداخت قبض pay_bill :

توسط این مند می توانید قبض ها را توسط شناسه پرداخت و شناسه قبض، پرداخت نمائید.

 

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

نام پارامتر مثال ضروریت توضیح
action pay_bill اجباری نام متد
username 123 اجباری نام کاربری وب سرویس
password 321 اجباری پسورد وب سرویس
bill_id 12345678910 اجباری شناسه قبض
pay_id 326541 اجباری شناسه پرداخت
mobile 09123456789 اجباری شماره موبایل خریدار (جهت پشتیبانی در صورت بروز مشکل)
order_id 1223 اجباری شماره تراکنش در سایت شما (باید منحصر به فرد باشد)

 

مقادیر بازگشتی متد pay_bill :

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

نام پارامتر مثال توضیح
res_code 1 در صورت موفق بودن عدد 1 در غیر این صورت مطابق جدول کدهای خطا
ref_code 65455 شماره پیگیری تراکنش

 

متد خرید محصول buy_product :

توسط این مند می توانید نسبت به خرید محصولاتی که توسط متد products دریافت نموده اید اقدام نمائید.

توجه نمائید با توجه به امکان تغییر قیمت یا لیست محصولات، همواره از طریق متد products لیست محصولات را دریافت نمائید

 

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

نام پارامتر مثال ضروریت توضیح
action buy_product اجباری نام متد
username 123 اجباری نام کاربری وب سرویس
password 321 اجباری پسورد وب سرویس
product_id CC-MCI-1000 اجباری آیدی محصول (دریافت شده توسط متد products)
count 2 اختیاری در صورت عدم ارسال این پارامتر مقدار 1 در نظر گرفته می شود
mobile 09123456789 اجباری شماره موبایل خریدار (جهت پشتیبانی در صورت بروز مشکل)
order_id 1223 اجباری شماره تراکنش در سایت شما (باید منحصر به فرد باشد)

 

مقادیر بازگشتی متد buy_product :

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

نام پارامتر مثال توضیح
res_code 1 در صورت موفق بودن عدد 1 در غیر این صورت مطابق جدول کدهای خطا
buy_info [{“Pin”:”878758437631248″,”ExtraData”:{“Serial”:”90170526170019607″}}] اطلاعات محصولات خریداری شده به صورت آرایه json
ref_code 65455 شماره پیگیری

کدهای خطا res_code

کد خطا توضیح
1 عملیات موفقیت آمیز است
11- اطلاعات ارسال شده ناقص است
12- شماره تلفن وارد شده در شارژ مستقیم صحیح نمی باشد یا با نوع اپراتور همخوانی ندارد
13- شناسه قبض نامعتبر است.
14- شناسه پرداخت نامعتبر است.
15- شناسه قبض و شناسه پرداخت همخوانی ندارند.
16- قبضی با این مشخصات قبلاً در سیستم ثبت شده است.
18- شماره تلفن وارد شده مربوط به سیم کارت دائمی همراه اول نمی باشد
22- اطلاعات احراز هویت صحیح نیست.
33- اعتبار نماینده کمتر از مبلغ درخواستی است.
44- مبلغ درخواست خارج از محدوده است یا محصول مورد نظر موجود نمی باشد
55- تراکنشی با شماره ارسال شده وجود ندارد.
66- اپراتور شارژ مستقیم ایرانسل در دسترس نمی باشد.
67- اپراتور شارژ مستقیم همراه اول در دسترس نمی باشد
77- شماره درخواست (order_id) تکراری است.
91- سیستم موقتاً با مشکل مواجه شده است.

 

امنیت در ربات فروش شارژ چگونه تامین می شود؟

در این مطلب شما را با نحوه کار ربات ها و امنیت انجام تراکنش توسط آن ها مطلع می نمائیم. با ما همراه باشید.

 

شاید در اولین برخورد شنیدن واژه ربات، برای برخی حاوی بار منفی باشد.

اما واقعا ربات چیست و به چه دردی می خورد؟

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

ربات ها خستگی ناپذیر هستند و سرعت پاسخگویی بسیار بالاتری از انسان ها دارند.

اشتباهات ربات ها در مقایسه با انسان ها بسیار کمتر بوده و نزدیک صفر است.

ربات ها به انسان ها کمک می کنند تا در زمان ، هزینه ، انرژی و … صرفه جویی گردد.

آن ها با دریافت دستورات اولیه کاربر، شروع به پردازش نموده و پس از تجزیه و تحلیل اطلاعات، خروجی مناسب را با توجه به درخواست کاربر را آماده نموده و ارائه می دهند.

 

چرا خرید شارژ توسط ربات با صرفه تر است ؟

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

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

انجام یک تراکنش توسط ربات بسیار اسان بوده و نیاز به داشتن مهارت یا دانش فنی نمی باشد. لذا مانع از سردرگمی کاربران می شود.

ربات تنها اطلاعات اولیه متناسب با نوع خدمات درخواستی کاربر را دریافت می کند ( مانند نوع اپراتور و مبلغ آن در خرید شارژ و یا شناسه قبض ).و اطلاعات کارت بانکی خریدار را دریافت نمی کند.

و اطلاعات بانکی افراد در شبکه امن بانکی و تحت پروتکل https در وب سایت shaparak.ir که زیر نظر بانک مرکزی فعالیت می کند دریافت می شود.

لذا خود ربات هیچگونه اطلاعات کارتی شما را دریافت و یا ذخیره نمی کند.

  • در صورتی که از ربات تلگرام برای خرید ، استفاده می کنید برای اطمینان از مشاهده وب سایت شاپرک، ابتدا از طریق گزینه setting تلگرام، گزینه In-App Browser را غیرفعال کنید سپس به ربات پیام دهید.

https://t.me/inaxbot

  • سپس به عنوان مثال یک کارت شارژ درخواست نمائید. پس از انتخاب اپراتور و مبلغ شارژ، توسط ربات فاکتوری به همراه لینک پرداخت برای شما ارسال می شود .
  • بر روی لینک پرداخت کلیک نمائید.
  • اکنون صفحه ای در مرورگر شما جهت باز کردن لینک پرداخت باز می شود که مشاهده خواهید کرد شما را به سایت shaparak.ir جهت وارد کردن اطلاعات بانکی هدایت می کند.
  • پس از وارد کردن شماره کارت و رمز دوم بر روی دکمه پرداخت کلیک نمائید تا دوباره به سایت اصلی ربات به آدرس inax.ir هدایت شوید.
  • اکنون در صورتی که وجه فاکتور توسط شما در صفحه بانک پرداخت شده باشد . سیم کارت شما شارژ خواهد شد.

 

لذا امنیت اطلاعات کاربران چه در سایت shaparak.ir و چه در سایت inax.ir کاملا تامین گردیده و توسط پروتکل https رمزگزاری گردیده است.

 

 

خرید شارژ توسط ربات تلگرام آینکس

آیا می دانید برای خرید شارژ تلفن همراه و یا پرداخت قبوض می توانید از طریق تلگرام اقدام کنید؟

برای خرید شارژ ایرانسل،همراه اول، رایتل و یا پرداخت قبض توسط ربات تلگرام inaxbot می توانید از راهنمای زیر استفاده کنید.

 

 

مزایای این روش:

  • در این روش دیگر نیازی به خروج از برنامه تلگرام نیست و تمام عملیات انتخاب و صدور فاکتور پرداخت در تلگرام انجام می شود
  • عملیات دریافت شماره کارت و رمز دوم در سایت بانکها انجام می شود و از لحاظ امنیت به مراتب بالاتر از روش های دیگر مانند USSD است.
  • نیاز به داشتن اینترنت پر سرعت نبوده و با یک اینترنت معمولی و با پهنای باند کم نیز امکان خرید وجود دارد.

 

آموزش خرید شارژ:

– ابتدا بر روی ربات خرید inax کلیک کنید.inaxBot

– سپس عبارت Start را لمس کنید.

 

 

– ربات به شما پیام خوش امد گویی ارسال می کنید مانند تصویر، عبارت charge/ را لمس کنید.

 

 

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

– پس از ارسال موارد فوق، فاکتوری جهت پرداخت برایتان صادر می گردد. جهت پرداخت بر روی لینک خرید کلیک کنید.

– در مرحله بعد شما وارد سایت بانک می شوید. اطلاعات کارت بانکی و رمز دوم خود را در سایت وارد نموده و بر روی دکمه “پرداخت” کلیک نمائید.

– در صورت موفقیت آمیز بودن خرید سیم کارت شما شارژ می گردد.

به همین سادگی…

نمایندگی فروش کارت شارژ از طریق تلگرام

در صورتی که مایل هستید بدون داشتن وب سایت و تنها با داشتن یک آیدی تلگرام، نمایندگی فروش کارت شارژ ساخته و درآمد کسب کنید با ما همراه باشید.

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

راهنمای کلی نمایندگی فروش کارت شارژ :

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

دریافت‌ نمایندگی رایگان می باشد.

شارژ 1,000 تومانی (مبلغ سود شما : 20 تومان)
شارژ 2,000 تومانی (مبلغ سود شما : 40 تومان)
شارژ 5,000 تومانی (مبلغ سود شما : 100 تومان)
شارز 10,000 تومانی (مبلغ سود شما : 200 تومان)
شارژ 20,000 تومانی (مبلغ سود شما : 400 تومان)

 

آموزش ساخت ربات تلگرام:

  • به ربات تلگرام BotFather پیام بدهید سپس start را انتخاب کنید.
  • از طریق گزینه newbot نسبت به ساخت ربات جدید برای خودتان اقدام نموده و یک نام برای ربات انتخاب کنید(می توانید از نام فارسی استفاده کنید. مانند: ربات خرید کارت شارژ)
  • سپس از شما درخواست نام کاربری می نماید(به عنوان مثال : test_bot). این نام منحصر به فرد بوده و در صورتی که نام انتخابی شما قبلا ثبت نشده باشد یک token به شما اختصاص داده می شود.
  • اکنون مراحل ساخت ربات به اتمام رسید نام کاربری و توکن را در جایی ذخیره نمائید زیرا در ادامه به آن نیاز خواهید داشت.

آموزش تنظیم عکس پروفایل برای ربات :

  • به ربات تلگرام BotFather پیام بدهید
  • از طریق گزینه mybots رباتی که قصد دارید برایش عکس پروفایل اضافه کنید را انتخاب کنید.
  • بر روی گزینه edit Bot کلیک کنید.
  • سپس بر روی گزینه Edit Botpic کلیک نموده و تصویر مورد نظر خود را ارسال نمائید

آموزش ساخت خط فرمان تلگرام:

منظور از خط فرمان همان command هایی است که به ربات معرفی می گردد.

  • به ربات تلگرام BotFather پیام بدهید سپس start را انتخاب کنید.
  • از طریق گزینه mybots رباتی که قصد دارید برایش command اضافه کنید را انتخاب کنید.
  • خط فرمان های مورد نظر خود را مانند فرمت زیر به ربات معرفی نمائید. بدین صورت که یک اسلش در ابتدا سپس واژه انگلیسی و توضیحات آن در مقابلش نوشته می شود به عنوان مثال

/help – راهنما

/charge – خرید شارژ مستقیم

/pin – خرید شارژ پین

/bill – پرداخت قبوض

/internet – بسته اینترنت

/giftcard – گیفت کارت

/antivirus – آنتی ویروس

/reseller – نمایندگی فروش شارژ

/support – پشتیبانی و تماس با ما

/cancel – لغو عملیات

پس از معرفی این فرمان ها مانند تصویر زیر در صفحه ربات شما یک خط مورب در کنار بخش چت افزوده می شود.

که پس از کلیک بر روی آن مانند تصویر زیر لیست فرمان ها ظاهر می گردد:

آموزش ارتباط ربات به نمایندگی فروش کارت شارژ :

  • به ربات تلگرام irpay_bot پیام بدهید سپس start را انتخاب کنید.
  • گزینه نمایندگی فروش شارژ یا reseller انتخاب نمائید.
  • از شما درخواست نام کاربری ربات می نماید (نام کاربری ربات خود را که در بالا ساخته بودید معرفی کنید. در صورتی که قبلا ربات ساخته اید نام کاربری آن را اینجا بنویسید)
  • سپس از شما توکن ربات درخواست می گردد. (در صورتی که توکن خود را فراموش کرده اید به ربات تلگرام BotFather پیام بدهید و گزینه mybots و سپس نام کاربری ربات خود را انتخاب کنید در مرحله بعد API Token را بزنید. در صورتی که قصد تغییر توکن خود را دارید در همین مرحله گزینه Revoke current token را بزنید تا توکن جدیدی به شما اختصاص یابد )
  • اکنون ربات فروش شارژ شما ساخته شده و آماده استفاده است می توانید آن را به دوستان خود معرفی کرده و درآمد کسب کنید.

 

در صورتی که شما مدیر ربات باشید (یعنی ربات از سوی شما ساخته شده باشد) گزینه های مدیریتی مانند مشاهده موجودی، نمایش گزارش فروش و … برای شما فعال خواهد شد که در ادامه با نحوه کار با آنها آشنا خواهید شد.

نحوه مشاهده موجودی یا سود فروش:

  • به رباتی که ساخته اید پیام بدهید
  • از گزینه credit جهت مشاهده اعتبار مبلغ سود کلی که از فروش کارت شارژ ها دریافت کرده اید استفاده نمائید.

 

نحوه مشاهده گزارش فروش کارت شارژ:

  • به رباتی که ساخته اید پیام بدهید.
  • از طریق گزینه logs می توانید ده گزارش آخر فروش خود را مشاهده نمائید.

 

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

  • به ربات خود پیام بدهید.
  • گزینه account را انتخاب کنید
  • سپس به ترتیب نام صاحب حساب، شماره حساب، شماره کارت و شماره شبا از شما درخواست می گردد موارد را وارد نمائید.

 

نحوه درخواست واریز سود های دریافتی:

در صورتی که مبلغ سود دریافتی شما به 500 تومان رسیده باشد می توانید درخواست واریز ثبت نمائید.

  • به ربات خود پیام بدهید
  • گزینه درخواست واریز یا withdraw را انتخاب کنید.
  • شماره حساب جهت واریز وجه را انتخاب کنید (در صورتی که از قبل شماره حساب خود را در سیستم ثبت نکرده باشید از شما درخواست می گردد ابتدا شماره حساب خود را ثبت نمائید)
  • روش واریز وجه (پایا یا شتابی) را انتخاب نمائید توجه نمائید در روش کارت به کارت کارمزد انتقال وجه از مبلغ درخواستی کسر خواهد گردید
  • مبلغ درخواستی جهت واریز را انتخاب نمائید.
  • در صورتی که موجودی حساب شما کافی باشد درخواست واریز شما ثبت خواهد شد و تا ساعاتی دیگر به حسابی که معرفی نموده اید واریز خواهد گردد.

 

چنانچه همچنان سوالی در رابطه با نحوه کار ربات در ذهن دارید می توانید به آیدی تلگرام irpulco پیام بدهید.