مرحله اول : ارسال دیتا

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

نکته : تمامی داده های برگشتی از pay.ahura.life به صورت json می باشد

post

https://pay.ahura.life/payment/send.php

پارامتر

فیلد	نوع	توضیحات
api	String	مرچنت کد دریافتی از پنل کاربری شما که بعد از تایید درخواست درگاه صادر میشه
amount	Integer	مبلغ تراکنش به صورت تومانی و بزرگتر یا مساوی 1000
CallBack	String	آدرس بازگشتی که می توان به صورت urlencode ، که باید با آدرس درگاه پرداخت تایید شده در pay.ahura.life بر روی یک دامنه باشد
factorNumber	String	شماره فاکتور شما (اختیاری)
description	String	توضیحات (اختیاری ، حداکثر 255 کاراکتر)

• پاسخ دریافتی در صورت صحت اطلاعات ارسالی

HTTP/1.1 200 OK
{
  "status" : true,
  "token" : شناسه پرداخت
}

• پاسخ دریافتی در صورت بروز خطا

HTTP/1.1 422 Error
{
  "status" : 0,
  "error" : متن پیام خطا
}

مرحله دوم : انتقال کاربر به صفحه پرداخت

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

برای اینکار باید عددی که در مرحله اول در متغییر {token} دریافت کردید رو در اخر ادرس قرار بدید و کاربر رو به URL ایجاد شده ریدایرکت کنید تا بلافاصله کاربر به درگاه پرداخت هدایت بشه و سپس مرحله سوم رو انجام بدید.

get

https://pay.ahura.life/payment/send.php?token={token}

مرحله سوم : بازگشت به سایت پذیرنده

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

get

http://Your-CallBack-URL?Authority={Authority}

مرحله چهارم : وریفای تراکنش

در صورتی که مقدار فیلد status دریافت شده در مرحله قبل عدد 1 باشه برای وریفای تراکنش باید کارهای زیر رو انجام بدید.

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

بدیهیست اگر شماره تراکنش ( transId ) از قبل در بانک اطلاعاتی پذیرنده وجود داشته باشد، نباید خدمات و محصولی به مشتری ارائه شود.

post

https://pay.ahura.life/payment/verify.php

پارامتر

فیلد	نوع	توضیحات
api	String	مرچنت کد دریافتی از سایتpay.ahura.life
transId	Integer	کد Authority دریافتی از مرحله callback

• پاسخ دریافتی در صورت صحت اطلاعات ارسالی

HTTP/1.1 200 OK
{
  "status" : 1,
  "amount" : مبلغ تراکنش,
  "transId" : شماره تراکنش,
  "factorNumber" : شماره فاکتور,
  "description" : توضیحات,
  "cardNumber" : شماره کارت,
  "message" : OK,
}

• پاسخ دریافتی در صورت بروز خطا

HTTP/1.1 422 Error
{
  "status" : 0,
  "message" : متن پیام خطا
}