راهنمای استفاده از وب سرویس آقای پرداخت

۱-ایجاد تراکنش ، ارسال کاربر به بانک جهت پرداخت

۲-بررسی وضعیت پرداخت کاربر

ایجاد تراکنش ، ارسال کاربر به بانک جهت پرداخت

وب سرویس بر پایه POST میباشد.

تراکنش باید مقادیر زیر را به آدرس http://panel.aqayepardakht.ir/api/create/ ارسال کنید.

متغیر	توضیحات	مثال
amount	مبلغ تراکنش - به تومان - حداقل ۱۰۰ تومان	20000
pin	کد پین درگاه	B5152C192A7645FF8A
callback	ادرس برگشت - عملیات بررسی پرداخت در این ادرس انجام میشود	http://website.com/callback/22
bank	نام بانک جهت پرداخت	mellat
description	توضیحات تراکنش	افزایش موجودی کاربر

* توجه : در متغیر bank میتوانید از مقادیر mellat برای بانک ملت ، saman برای بانک سامان و meli برای بانک ملی استفاده کنید.درصورت خالی گذاشتن این مقدار ، به صورت پیشفرض روی بانک ملت میباشد.

* بعد از ارسال مقادیر بالا به وب سرویس با متد POST، درصورتی که مقادیر را درست وارد کرده باشید کد تراکنش را دریافت میکنید.

سپس کاربر را به ادرس زیر انتقال دهید :

http://panel.aqayepardakht.ir/startpay/TRANSID

به جای TRANSID باید شماره تراکنش را وارد کنید.

این مرحله به اتمام رسید. برای بررسی وضعیت پرداخت باید مرحله ی دوم را انجام دهید.

بررسی وضعیت پرداخت کاربر

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

* توجه : هنگام برگشت کاربر به وبسایت شما (callback) یک متغیر با نام transid که حاوی کد تراکنش می باشد با متد POST به آدرس callback شما ارسال میشود.

* برای بررسی وضعیت تراکنش شما نیاز به ۱-کد تراکنش ۲-مبلغ ۳-کد پین درگاه دارید.

جهت بررسی وضعیت تراکنش باید مقادیر زیر را به آدرس http://panel.aqayepardakht.ir/api/verify/ ارسال کنید.

متغیر	توضیحات	مثال
amount	مبلغ تراکنش	20000
transid	کد تراکنش - در مرحله ي اول دریافت شد	C82866D63C
pin	کد پین درگاه	B5152C192A7645FF8A

بعد از ارسال مقادیر بالا با متد POST درصورتی که خروجی 1 باشد به معنای “تراکنش پرداخت شده است ” و اگر خروجی برابر با 0 باشد به معنای “تراکنش پرداخت نشده است” می باشد.

شرح کد های خطا

توضیحات	کد خطا
amount میتواند خالی باشد	1-
کد پین درگاه نمیتواند خالی باشد	2-
callback نمیتواند خالی باشد	3-
amount باید عددی باشد	4-
amount باید بزرگتر از ۱۰۰ باشد	5-
کد پین درگاه اشتباه هست	6-
ایپی سرور با ایپی درگاه مطابقت ندارد	7-
transid نمیتواند خالی باشد	8-
تراکنش مورد نظر وجود ندارد	9-
کد پین درگاه با درگاه تراکنش مطابقت ندارد	10-
مبلغ با مبلغ تراکنش مطابقت ندارد	11-
بانک وارد شده اشتباه میباشد	12-
درگاه غیر فعال است	13-
درگاه برروی سایت دیگری درحال استفاده است	14-