وب سرویس درگاه بانک – راهنمای استفاده

وب سرویس درگاه بانک – راهنمای استفاده

وب سرویس درگاه بانک - راهنمای استفادهReviewed by واحد فنی on Apr 24Rating: 5.0وب سرویس درگاه بانک - راهنمای استفادهبرای شروع کار و استفاده از وب سرویس درگاه بانک، این راهنما را مطالعه کنید. جهت استفاده از این وب سرویس از پروتکل Soap استفاده شده است

وب سرویس درگاه بانک:

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

برای استفاده از سرویس پرداخت درگاه بانک از تکنولوژی وب سرویس (web service) استفاده شده است. زیرا پذیرنده میتواند از هر نوع تکنولوژی و زبان برنامه نویسی برای اتصال به آن استفاده نماید.

انتقال اطلاعات بین پذیرنده و درگاه بانک توسط پروتکل SOAP که مخفف (Simple Object Access Protocol) انجام خواهد گردید. در این پروتکل از استاندارد XML جهت دسته بندی و مدیریت داده ها استفاده می شود و انتقال داده ها توسط پروتکل HTTP و HTTPS انجام می شود.

 

پیش نیازها :

  • جهت استفاده از این سرویس ، شما باید در سایت ثبت نام نموده و یک حساب تائید شده و شناسه درگاه داشته باشید.
  • پورت های 443 و 80 سرور میزبان باید جهت اتصال به این سرویس باز باشند.
  • پروتکل SOAP باید بر روی سرور میزبان فعال باشد.

 

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

جهت استفاده از وب سرویس باید آدرس زیر را توسط پروتکل SOAP صدا بزنید.

 

شرح متدها :

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

  • Payment
  • PaymentVerification

 

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

با استفاده از متد Payment پذیرنده درخواست انجام یک تراکنش را برای درگاه بانک ارسال می کند در صورتی که صحت اطلاعات ارسالی تائید گردد (توسط پارامترهای ورودی که به صورت آرایه ارسال می گردد) کد منحصر به فرد این درخواست (کد تراکنش) برای پذیرنده تولید و ارسال می گردد . مقدار بازگشتی این متد یک رشته عددی بزرگتر از صفر می باشد . مثال : 4220

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

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

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

 

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

نام پارامتر مثال ضروریت توضیح نوع
plugin whmcs اختیاری نام پلاگین string
webgate_id 40722857 ضروری شناسه درگاه پذیرنده integer
order_id 2564 اختیاری شماره خرید در سایت پذیرنده integer
phone 09123456789 اختیاری شماره تلفن خریدار string
email [email protected] اختیاری ایمیل خریدار string
amount 20000 ضروری مبلغ تراکنش به ریال integer
CallbackURL http://example.com/orderid=2564 ضروری لینک بازگشت string
Description شارژ ایرانسل دو هزار تومانی اختیاری توضیحات خرید string

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

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

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

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

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

 

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

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

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

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

 

 

در صورتی که تراکنش موفق باشد پارامترهای زیر با استفاده از متد POST به آدرس CallBack پذیرنده که در متد Payment به درگاه بانک اعلام شده است ارسال می گردد :

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

جدول شماره 3 : شرح مقادیر ارسالی متد Payment

 

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

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

مقدار بازگشتی این متد یک رشته حاوی کد پاسخ می باشد که در جدول 4 درج شده است.

 

1-2 پارامترهای ورودی متد PaymentVerification :

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

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

 

 

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

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

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

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

نام سیستم نام پلاگین plugin
وردپرس افزونه Paid Download wordpress_paiddownload
افزونه Advanced VIP wordpress_advanced_vip
افزونه vip wordpress wordpress_vip_wordpress
افزونه Easy Digital Download نسخه 1 wordpress_edd
افزونه Easy Digital Download نسخه 2 wordpress_edd2
افزونه Restrict Content Pro wordpress_rcp
افزونه امتیاز بندی کاربران با myCRED wordpress_mycred
فروشگاه ساز ووکامرس (نسخه 1) wordpress_woocommerce1
فروشگاه ساز ووکامرس (نسخه 2) wordpress_woocommerce2
فروشگاه ساز ووکامرس ((نسخه 3) wordpress_woocommerce3
فرم ساز گراویتی فرم (Gravity Forms) در وردپرس (نسخه 1) wordpress_gravity1
فرم ساز گراویتی فرم (Gravity Forms) در وردپرس (نسخه 2) wordpress_gravity2
جوملا فروشگاه ساز هیکاشاپ سازگار با جوملا 3 joomla_hikashop
فروشگاه ساز جوم شاپینگ سازگار با جوملا 3 joomla_joomshopping
پلاگین ماژول آسان پرداخت سازگار با جوملا 3 joomla_asanpardakht
ماژول فروش تکی محصول سازگار با جوملا 3 joomla_single_product
کامپوننت RSForm سازگار با جوملا 3 joomla_rsform
فروشگاه ها فروش کارت شارژ و محصولات دیجیتال Freer freer
فروش کارت شارژ و محصولات دیجیتال CShop cshop
فروش کارت شارژ و محصولات دیجیتال Cardstore Cardstore
ViProg Viprog
فروشگاه پرستاشاپ prestashop
فروشگاه اپن کارت opencart
مدیریت هاستینگ مدیریت هاستینگ WHMCS whmcs
دیگر سیستم ها اسکریپت حرفه ای دانلود و فروش فایل VIP Vip_final
اسکریپت شبکه اجتماعی PHPFOX PHPFox
اسکریپت سیستم کلیکی PTC PTCIran
دیگر سیستم ها other
آسان پرداخت اسکریپت آسان پرداخت درگاه بانک نسخه 1 asanpardakht1
اسکریپت آسان پرداخت درگاه بانک نسخه 2 asanpardakht2

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

 

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

برای دانلود نمونه کدهای اتصال به درگاه بانک ورژن Soap و Nusoap بر روی لینک زیر کلیک کنید :

http://dl.dargahbank.ir/sample_code.zip

دانلود افزونه آموزش تصویری (PDF)

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

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

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

تاریخ انتشار : 26 بهمن 1395
مشاهده مطلب
امنیت در شبکه های بی سیم

امنیت در شبکه های بی سیم

تاریخ انتشار : 20 بهمن 1395
مشاهده مطلب
معرفی افزونه Yoast Seo افزونه ای برای بررسی وضعیت Seo پست ها

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

تاریخ انتشار : 20 بهمن 1395
مشاهده مطلب
روش و آشنایی با نحوه اتصال به درگاه های بانکی برای وب سایت ها

روش و آشنایی با نحوه اتصال به درگاه های بانکی برای وب سایت ها

تاریخ انتشار : 19 بهمن 1395
مشاهده مطلب
آشنایی با سیستم مدیریت محتوای وردپرس و قابلیت های این CMS محبوب

آشنایی با سیستم مدیریت محتوای وردپرس و قابلیت های این CMS محبوب

تاریخ انتشار : 18 بهمن 1395
مشاهده مطلب
آشنایی با CMS یا Content Management System یا سیستم مدیریت محتوا

آشنایی با CMS یا Content Management System یا سیستم مدیریت محتوا

تاریخ انتشار : 18 بهمن 1395
مشاهده مطلب
وَمَا مِن دَآبَّةٍٍ فِِی الأَرْضِ إِلاَّ عَلَی اللّهِ رِزْقُهَا وَیَعْلَمُ مُسْتَقَرَّهَا وَمُسْتَوْدَعَهَا کُلٌّ فِی کِتَابٍ مُبِینٍ(هود/6)؛ «هیچ جنبنده ای در زمین نیست، مگر اینکه روزی او برخداست. او قرارگاه و محلّ نقل و انتقالش را می داند. همه اینها در کتاب آشکاری ثبت است».