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

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

راهنمای استفاده از وب سرویس ایرپولReviewed by ایرپول on Apr 24Rating: 5.0راهنمای استفاده از وب سرویس ایرپولدر این بخش نحوه استفاده از وب سرویس پرداخت ایرپول به صورت کامل آموزش داده می شود. در این وب سرویس امکان استفاده از تمام زبان های برنامه نویسی از طریق پروتکل XML فراهم می باشد

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

 

webservice

 

 

پیش از هر چیز ار فعال بودن SOAP بر روی سرور خود اطمینان حاصل نمائید

 

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

https://irpul.com/webservice.php?wsdl

 

شرح متدها :

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

  • Payment
  • PaymentVerification

 

متد درخواست خرید Payment :

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

 

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

نام پارامتر مثال ضروریت توضیح نوع
plugin whmcs اختیاری نام پلاگین string
webgate_id 40720850 ضروری شناسه درگاه پذیرنده integer
order_id 2564 اختیاری شماره خرید در سایت پذیرنده integer
product ثبت دامنه بین المللی اختیاری نام محصول خریداری شده string
payer_name حسن ابراهیمی اختیاری نام خریدار string
phone 021-123456789 اختیاری شماره تلفن خریدار string
mobile 09123456789 اختیاری موبایل خریدار string
email [email protected] اختیاری ایمیل خریدار string
amount 20000 ضروری مبلغ تراکنش به ریال integer
callback_url http://example.com/orderid=2564 ضروری لینک بازگشت string
address تهران – خیابان آفریقا کوچه صبا پلاک 10 اختیاری آدرس خریدار string
description لطفا سریع تر پیگیری کنید. اختیاری توضیحات خرید string

جدول شماره 1 : شرح پرامترهای وروردی متد Payment

 

نکته 1 : پارامترهای ارسالی باید مطالبق جدول شماره 1 ارسال گردد ، مقادیر حساس به حروف کوچک و بزرگ می باشند.

نکته 2 : پارامتر plugin صرفا جهت آمارگیری استفاده می شود و می توانید از نام انگلیسی پلاگین ها استفاده کنید (نام انگلیسی پلاگین ها در این صفحه درج شده است). در صورتی که نام پلاگین مورد استفاده شما در لیست موجود نیست مقدار آن را other و یا خالی ارسال کنید همچنین میتوانید نام اسکریپت را به همراه فایل پلاگین برای ما ارسال کنید تا با نام و آدرس سایتتان در سایت درج گردد.

نکته 3 : جهت استفاده از حالت تست شناسه درگاه را 0 قرار دهید.

نکته 4 : مبلغ تراکنش حتما باید به ریال ارسال گردد.

نکته 5 : شناسه تراکنش 15 دقیقه اعتبار داشته و پس از آن منقضی می گردد.

 

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

پس از درخواست خرید توسط متد Payment یک آرایه حاوی پارامتر های زیر بازگشت داده می شود

نام پارامتر مثال توضیح نوع
res_code 1 کد نتیجه integer
status success عملیات موفقیت آمیز string
tran_id 3254544 شناسه تراکنش integer
url https://irpul.com لینک شروع خرید string

جدول شماره 2 : مقادیر بازگشتی متد Payment

 

شرح کدهای خطا res_code

کد خطا توضیح
1 عملیات موفقیت آمیز است
1- شناسه درگاه خالی است
2- شناسه درگاه اشتباه است
3- حساب کاربر تایید نشده است
4- مبلغ خالی است
5- مبلغ اشتباه است
6- شماره سفارش صحیح نیست
7- لینک بازگشت خالی است
8- لینک بازگشت اشتباه است
9- آدرس ایمیل اشتباه است
10- شماره تلفن اشتباه است
11- پاسخی دریافت نشد
12- مقدار plugin خالی است
13- مقدار plugin اشتباه است
14- عملیات ناموفق
15- درگاه فعال نیست
16- لینک بازگشتی با لینک درگاه متفاوت است.
17- نام محصول صحیح نیست.
18- نام خریدار معتبر نیست.
19- تلفن همراه صحیح نیست.
20- آدرس معتبر نیست.
21- توضیحات خرید معتبر نیست.

جدول شماره 3 : شرح کد خطا res_code

 

متد تایید تراکنش خرید PaymentVerification :

برای بررسی وضعیت خرید (استعلام وضعیت تراکنش) از این متد استفاده می شود. وضعیت خرید پس از بازگشت از ایرپول با توجه پارامتر irpul_token که به صورت کد شده و توسط متد GET به سایت پذیرنده ارسال شده است بررسی می گردد.

برای دیکد کردن پارامتر irpul_token از فانکشن url_decrypt که در سمپل کد های انتهای این آموزش قرار داده شده است استفاده نمائید

این پارامتر پس از دیکد شدن و عبور از فانکشن parse_str یک آرایه به همراه 5 پارامتر تولید میکند که در جدول شماره 4 شرح داده شده است.

نام پارامتر مثال توضیح نوع
tran_id 4220 شماره خرید integer
order_id 2564 شماره خرید ارسالی پذیرنده integer
amount 20000 مبلغ تراکنش integer
refcode 51461017445 رسید منحصر به فرد تراکنش integer
status paid وضعیت تراکنش(paid,unpaid) string

جدول شماره 4 : مقادیر دیکد شده پارامتر irpul_token

 

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

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

نام پارامتر مثال ضروریت توضیح نوع
webgate_id 40722857 ضروری شناسه درگاه پذیرنده integer
Tran_id 2564 ضروری شماره خرید integer
amount 20000 ضروری مبلغ تراکنش به ریال integer

جدول شماره 5 : شرح پارامترهای وروردی متد PaymentVerification

 

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

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

کد خطا توضیح
1 پرداخت با موفقیت انجام شده است
1- شناسه درگاه خالی است
2- شناسه درگاه اشتباه است
3- tran_id خالی است
4- tran_id اشتباه است
5- مبلغ خالی است
6- مبلغ عددی نیست
7- مبلغ تراکنش صحیح نیست
8- تراکنش پرداخت نشده
10- شماره تراکنش عددی نیست
11- شناسه درگاه باید عددی باشد
12- تراکنش قبلا verify شده است

جدول شماره 6 : شرح مقادیر بازگشتی متد PaymentVerification

 

لیست پلاگین های تعریف شده :

جهت مشاهده لیست پلاگین های تعریف شده اینجا کلیک کنید

 

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

برای دانلود نمونه کد اتصال به وب سرویس ایرپول به زبان php بر روی لینک زیر کلیک کنید :

https://dl.irpul.com/sample_code.zip


ارسال نظر

دیگر مطالب مرتبط

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

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

تاریخ انتشار : ۲۶ فروردین ۱۳۹۶
مشاهده مطلب
آموزش کاهش حجم تصاویر

آموزش کاهش حجم تصاویر

تاریخ انتشار : ۲۳ فروردین ۱۳۹۶
مشاهده مطلب
نکات امنیتی حفاظت از اطلاعات حساب بانکی

نکات امنیتی حفاظت از اطلاعات حساب بانکی

تاریخ انتشار : ۱۲ فروردین ۱۳۹۶
مشاهده مطلب
روش های شناسایی تراکنش های مشکوک

روش های شناسایی تراکنش های مشکوک

تاریخ انتشار : ۱۲ فروردین ۱۳۹۶
مشاهده مطلب
درگاه پرداخت شخصی ایرپول

درگاه پرداخت شخصی ایرپول

تاریخ انتشار : ۱۲ بهمن ۱۳۹۵
مشاهده مطلب
خرید شارژ توسط ربات تلگرام

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

تاریخ انتشار : ۱۲ آبان ۱۳۹۵
مشاهده مطلب
هُوَ أَنْشَأَکُمْ مِنَ الْأَرْضِ وَ اسْتَعْمَرَکُمْ فِیه ---> اوست که شما را از زمین پدید آورد و از شما خواست تا در آن آبادى کنید. (هود /61)