مقدمه

به بخش مستندات وب سرویس های میلیونا خوش آمدید.

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

به صورت کلی یک فرآیند پرداخت شامل مراحل زیر می باشد:

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

آدرس تمامی وب سرویس های میلیونا با آدرس زیر شروع خواهند شد:

https://api.milyoona.com

برای تست وب سرویس ها می توانید مقدار زیر را در فیلد terminal قرار دهید:

milyoona

موارد قابل توجه:

• توکن های دریافتی در مرحله اول تنها 20 دقیقه اعتبار خواهند داشت و شما در این زمان می توانید کاربر را به صفحه پرداخت هدایت نمایید و در غیر این صورت می بایست توکن جدیدی دریافت کنید.
• توجه داشته باشید که می توانید پیگیری تراکنش را قبل از مرحله سوم نیز انجام دهید.
• توجه داشته باشید در صورت عدم تایید تراکنش (مرحله سوم) پس از گذشت حداکثر 1 ساعت وجه پرداختی به حساب مبدا بازگشت داده خواهد شد.

دریافت توکن

Request:

                
$data = [
     'terminal' => $terminal,
     'amount' => $amount,
     'mobile' => $mobile,
     'national_code' => $national_code,
     'callback_url' => $callback_url,
     'order_id' => $order_id,
     'card_no' => $card_no,
     'description' => $description,
];

$request = curl_init('https://api.milyoona.com/payment/token');
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLINFO_HEADER_OUT, true);
curl_setopt($request, CURLOPT_POST, true);
curl_setopt($request, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: application/json',
);

$response = curl_exec($ch);
curl_close($ch);
dd($response)
                
            

                
$data = [
     'terminal' => $terminal,
     'amount' => $amount,
     'mobile' => $mobile,
     'national_code' => $national_code,
     'callback_url' => $callback_url,
     'order_id' => $order_id,
     'card_no' => $card_no,
     'description' => $description,
];

$client = new \GuzzleHttp\Client();
$response = $client-post("https://api.milyoona.com/payment/token", [
    'headers' => [
            'content-type' => 'application/json',
    ],
    'body' => json_encode($data)
]);

dd($response->getBody())
                
            

درخواست توکن می بایست به مسیر زیر از طریق متد POST ارسال گردد:

https://api.milyoona.com/payment/token

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

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

هدایت کاربر به درگاه پرداخت

Redirect:

                
header('Location: https://api.milyoona.com/ipg/' . $token);
                
            

                
return redirect("https://api.milyoona.com/ipg/" . $token);
                
            

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

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

https://api.milyoona.com/ipg/{token}

بعد از بازگشت کاربر از صفحه پرداخت مقادیر زیر به callback_url شما توسط متد GET ارسال خواهند شد:

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

تایید تراکنش

Request:

                
$data = [
     'terminal' => $terminal,
     'token' => $token,
];

$request = curl_init('https://api.milyoona.com/payment/verify');
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLINFO_HEADER_OUT, true);
curl_setopt($request, CURLOPT_POST, true);
curl_setopt($request, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
        'Content-Type: application/json',
);

$response = curl_exec($ch);
curl_close($ch);
dd($response)
                
            

                
$data = [
     'terminal' => $terminal,
     'token' => $token,
];

$client = new \GuzzleHttp\Client();
$response = $client-post("https://api.milyoona.com/payment/verify", [
    'headers' => [
            'content-type' => 'application/json',
    ],
    'body' => json_encode($data)
]);

dd($response->getBody())
                
            

درخواست تایید تراکنش می بایست به مسیر زیر از طریق متد POST ارسال گردد:

https://api.milyoona.com/payment/verify

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

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

پیگیری تراکنش

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

https://api.milyoona.com/payment/trace

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

تمامی مقادیر ارسالی و دریافتی در این مرحله همانند مرحله سوم می باشد.

جدول خطاها

جدول خطاهای احتمالی در انجام تراکنش: