#ایجاد تراکنش

# مرحله اول : ارسال پارامتر

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

آدرس وب سرویس

method: Post
URL: https://panel.aqayepardakht.ir/api/v2/create

از این وب سرویس برای ایجاد کد تراکنش استفاده می شود.

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

بعد از ارسال مقادیر بالا با متد POST خروجی به صورت زیر خواهد بود.

HTTP/1.1 200 OK

{
  "status" : "success",
  "transid" : "TransId"
}

HTTP/1.1 422 Error

{
  "status" : "error",
  "code" : "error code"
}

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

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

method: Get
URL: https://panel.aqayepardakht.ir/startpay/{transid}

method: Get
URL: https://panel.aqayepardakht.ir/startpay/sandbox/{transid}

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

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

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

آدرس وب سرویس

method: Post
URL: https://panel.aqayepardakht.ir/api/v2/verify

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

بعد از ارسال مقادیر بالا با متد POST خروجی به صورت زیر خواهد بود.

HTTP/1.1 200 OK

{
"status" : "success",
"code" : "1"
}

HTTP/1.1 422 Error

{
"status" : "error",
"code" : "error code"
}

# کد های خطا

  {
    '-1':'amount نمی تواند خالی باشد',
    '-2':'کد پین درگاه نمی تواند خالی باشد',
    '-3':'callback نمی تواند خالی باشد',
    '-4':'amount باید عددی باشد',
    '-5':'amount باید بین 1,000 تا 200,000,000 تومان باشد',
    '-6':'کد پین درگاه اشتباه هست',
    '-7':'transid نمی تواند خالی باشد',
    '-8':'تراکنش مورد نظر وجود ندارد',
    '-9':'کد پین درگاه با درگاه تراکنش مطابقت ندارد',
    '-10':'مبلغ با مبلغ تراکنش مطابقت ندارد',
    '-11':'درگاه درانتظار تایید و یا غیر فعال است',
    '-12':'امکان ارسال درخواست برای این پذیرنده وجود ندارد',
    '-13':'شماره کارت باید 16 رقم چسبیده بهم باشد',
    '-14':'درگاه برروی سایت دیگری درحال استفاده است',
    '-15':'آدرس کال بک ارسال شده با دامنه تایید شده درگاه پرداخت مغایرت دارد'
    '-16':'ارجاع دهنده نامعتبر است (Referrer ارسال نشده است)'
    '-17':'مقدار ارسال شده برای پارامتر callback_method باید POST یا GET  باشد'
}

<?php

// Send Parameter

$data = [
'pin'    => 'Gateway Pin',
'amount'    => 20000,
'callback' => 'https://mysite.com/verify.php',
'callback_method ' => 'GET',
'card_number' => '1111222233334444',
'mobile' => '09123456789',
'email' => 'test@test.com',
'invoice_id' => '123456',
'description' => 'Description'
];

$data = json_encode($data);
$ch = curl_init('https://panel.aqayepardakht.ir/api/v2/create');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLINFO_HEADER_OUT, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($data))
);
$result = curl_exec($ch);
curl_close($ch);
$result = json_decode($result);
if ($result->status == "success") {
    header('Location: https://panel.aqayepardakht.ir/startpay/' . $result->transid);
} else {
    echo "خطا";
}


// verify Transaction

$data = [
'pin'    => 'Gateway Pin',
'amount'    => 20000,
'transid' => $_GET['transid']
];

$data = json_encode($data);
$ch = curl_init('https://panel.aqayepardakht.ir/api/v2/verify');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLINFO_HEADER_OUT, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($data))
);
$result = curl_exec($ch);
curl_close($ch);
$result = json_decode($result);
if ($result->code == "1") {
// تراکنش موفق
} else {
// تراکنش ناموفق
}