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

برای نصب و استفاده از درگاه بانکی پرداخت اینترنتی 2 روش کلی وجود دارد.

 

- استفاده از وب سرویس (مخصوص وب سایت ها و فروشگاه ها، ... )

- استفاده از لینک پرداخت (وبلاگ ها و سایت هایی که فروش کمتری دارند یا روند کار وبلاگ یا سایت به پرداخت وابسته نیست. مانند: حمایت مالی و ...)

 

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

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

 

نشانی وب سرویس

http://payplus.ir/service.asmx

برای مشاهده سورس کد ها و نمونه ها اینجا کلیک فرمایید. (ASP.Net, PHP, ...)

 

متد Request

روش وب سرویس دارای چند بخش اصلی است که باید مطابق دستورالعمل اجرا شوند. ارسال درخواست توسط متد Request که signature دستور به شکل زیر است،

public PaymentRequest Request(string Username, string Password, int OrderId, int Amount, string Description, string Callback)

  

توضیحات نوع متغییر ورودی/خروجی نام متغیر
خروجی اصلی متد (توضیح بیشتر) Class خروجی اصلی متد PaymentRequest 
نام کاربری درگاه  String ورودی Username 
کلمه عبور درگاه  String  ورودی  Password
شماره سفارش که نباید تکراری باشد.  Int  ورودی OrderId 
مبلغ کل سفارش (عدد صحیح بزرگتر از 0)  Int  ورودی  Amount
توضیحات مربوط به سفارش (توضیح بیشتر)  String  ورودی  Description
لینک بازگشت به سایت (توضیح بیشتر)  String  ورودی  Callback


کلاس PaymentRequest

خروجی متد Request کلاسی است با مشخصات زیر:

توضیحات نوع متغییر نام متغییر
کد تراکنش، این کد را حتما در بانک اطلاعاتی خود ذخیره فرمایید. String Code
مسیر ورودی به درگاه، کاربر باید به این آدرس فرستاده شود. String PaymentPath
وضعیت درخواست (توضیح بیشتر) Enum Status

 

کلاس PaymentRequest وضعیت درخواست

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

توضیحات نام وضعیت
نام کاربری یا کلمه عبور معتبر نیست. AUTHENTICATION_FAILED
وب سایت تایید نشده است. WEBSITE_UNVERIFY
اطلاعات درخواستی اشتباه است. مثلا قیمت 0 است. INVALID_INFO
شماره سفارش تکراری است. DUPLICATE_ORDER_ID
عملیات موفقیت آمیز بوده و شما می توانید کاربر را به آدرس PaymentPath بفرستید. SUCCEED
به هر دلیل مشکلی در کار سایت یا درگاه بانک پیش آمده است. بعد از چند دقیقه دوباره تلاش نمایید. FAILED

 

توضیحات تراکنش یا Description

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

 

مسیر برگشت یا Callback

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

 

متد Verify

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

توجه داشته باشید: درصورتی که تراکنشی Verify نشود، بعد از 24 ساعت پول از حساب سایت خارج و به حساب مشتری نهایی برگشت داده می شود و سایت هیچ مسولیتی نخواهد داشت.

 public PaymentVerify Verify(string Username, string Password, string Code)

 

توضیحات نوع متغییر ورودی/خروجی نام متغیر
خروجی اصلی متد (توضیح بیشتر) Class خروجی اصلی متد PaymentVerify
نام کاربری درگاه String ورودی Username
کلمه عبور درگاه String ورودی Password
کد تراکنش String ورودی Code

 

کلاس PaymentVerify 

خروجی متد Verify که شامل خاصیت های زیر است.


توضیحات نوع متغییر ورودی/خروجی نام متغیر
خروجی اصلی متد (توضیح بیشتر) Class خروجی اصلی متد PaymentRequest 
نام کاربری درگاه  String ورودی Username 
کلمه عبور درگاه  String  ورودی  Password
شماره سفارش که نباید تکراری باشد.  Int  ورودی OrderId 
مبلغ کل سفارش (عدد صحیح بزرگتر از 0)  Int  ورودی  Amount
توضیحات مربوط به سفارش (توضیح بیشتر)  String  ورودی  Description
لینک بازگشت به سایت (توضیح بیشتر)  String  ورودی  Callback


کلاس PaymentRequest

خروجی متد Request کلاسی است با مشخصات زیر:

توضیحات نوع متغییر نام متغییر
کد تراکنش String Code
وضعیت تراکنش (توضیح بیشتر) Enum Status
مبلغ تراکنش Int Amount

 

کلاس PaymentRequest وضعیت تایید 

بعد از دریافت پاسخ از سایت یکی از وضعیت های زیر اعلام می شود. 

توضیحات نام وضعیت
کاربر موفق به پرداخت هزینه شده است. SUCCESSFUL
تراکنش ناموفق بوده و هزینه ای پرداخت نشده است. UN_SUCCESSFUL

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

 

نمونه سورس کدها 

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

لینک دانلود زبان برنامه نویسی فروشگاه/وبلاگ/مدیریت محتوی
دانلود دانلود (حجم: 141 کیلوبایت) ASP.Net 4 عمومی
دانلود دانلود (حجم: 3 کیلوبایت) PHP SoapClient عمومی
دانلود دانلود (حجم: 66 کیلوبایت) PHP nusoap عمومی
دانلود دانلود (حجم: 94 کیلوبایت) PHP nusoap پرستا شاپ پرستا شاپ
دانلود دانلود (حجم: 19 کیلوبایت) PHP SoapClient اوپن کارت اوپن کارت

 

 

 

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

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

 

لینک پرداخت با امکان ویرایش مبلغ: http://payplus.ir/pay/{GATEWAY-CODE}

 

لینک های شما

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

پیش نمایش لینک در قالب
حمایت مالی از ما
حمایت مالی از ما
حمایت مالی از ما
حمایت مالی از ما

 

 

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

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

نشانی سایت فروشگاه/وبلاگ/مدیریت محتوی
بلاگفا http://payplus.blogfa.com بلاگفا
پرشین بلاگ http://payplus.persianblog.ir پرشین بلاگ