مستندات و نمونه کدهای اتصال به وبسرویس

کلیه درخواست های ایجاد و شروع تراکنش باید به آدرس https://paymentpol.com/webservice/rest/PaymentRequest و کلیه درخواست های بررسی وضعیت و Verify کردن تراکنش به آدرس https://paymentpol.com/webservice/rest/PaymentVerification ارسال شوند, لذا در کد نویسی دقت داشته باشید آدرس وب سرویس RestFul به شکل زیر خواهد بود :

فرايند خريد ( Request )

لیست داده هاي برگشتی در پاسخ به فرايند خريد ( Request )

در صورت صحت داده ها پی پول یک داده از نوع string به طول 32 کاراکتر ( که Authority نام دارد ) و یک داده با نام Status برابر 100 بر می گرداند و سایت پذیرنده پس از دریافت این داده ها، مشتري را به سایت پی پول هدایت می نماید, توجه داشته باشید که در داده های برگشتی در صورتی که مقدار Status برابر با 100 نباشد, برابر با یک عدد منفی خواهد بود که شرح خطاهای هر عدد منفی را در تب کدهای برگشتی / خطا‌ها مشاهده کنید.

بعد از پايان عمليات درسمت پی پول, پی پول وظيفه دارد كاربر را به سايت پذيرنده كه از طريق CallbackURL مشخص شده است بازگرداند.

بطور مثال در صورتی که مقدار Status برابر با 100 و مقدار Authority دارای یک کد 32 کاراکتری ( به عنوان مثال : F5122EEC8CA035EC3A3C7318B333BB28 ) باشد بمنظور اتصال به درگاه بانکی و انجام عملیات پرداخت کاربر باید به آدرس زیر هدایت شود :

نمونه کد PHP ایجاد شناسه ی پرداخت ( Authority ) و ارجاع کاربر به درگاه پرداخت

<?php
$MerchantID 	= "XXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXXXXXX";
$Amount 	= 1000;
$InvoiceID 	= 10;
$Description 	= "Payment ID 10";
$Email 		= "buyer@example.com";
$Mobile 	= "09123456789";
$CallbackURL 	= "http://example.com/verify.php";

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://paymentpol.com/webservice/rest/PaymentRequest');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type' => 'application/json'));
curl_setopt($curl, CURLOPT_POSTFIELDS, "MerchantID={$MerchantID}&Amount={$Amount}&InvoiceID={$InvoiceID}&Description={$Description}&Email={$Email}&Mobile={$Mobile}&CallbackURL=". urlencode($CallbackURL));
curl_setopt($curl, CURLOPT_TIMEOUT, 30);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$curl_exec = curl_exec($curl);
curl_close($curl);

$result = json_decode($curl_exec);

if (isset($result->Status) && $result->Status == 100)
{
header("Location: {$result->PaymentUrl}");
} else {
echo (isset($result->Status) && $result->Status != "") ? $result->Status : "Error connecting to web service";
}
?>

فرایند بررسی وضعیت و نتیجه تراکنش ( Callback / Verify )

در صفحه CallbackURL پذيرنده وظيفه دارد درخواست معادل با Authority و PaymentStatus كه از طـرف پی پول و بـه صـورت POST به آدرس CallbackURL ارسال شده است را دریافت نموده و در صورتی که مقدار PaymentStatus دریافت شده برابر با " OK " بود, داده‌های جدول زیر را از طریق متـد POST به آدرس https://paymentpol.com/webservice/rest/PaymentVerification ارسال نموده و پاسخ دریافتی را چـك نمايد و در صورت موفق بودن، پرداخت را ثبت و شماره تراكنش را به كاربر خريدار نمايش دهد ؛ در غير اينصورت پذيرنده موظف اسـت كـه بـا توجه به كد خطايي كه دريافت ميكند كاربر را از خطاي رخ داده مطلع سازد. همچنین توجه داشته باشید در صورتی PaymentStatus برابر با " NOK " باشد, تراکنش ناموفق بوده و نیازی به ارسال درخواست PaymentVerification نیست.

براي Verify کردن تراکنش باید اطلاعات و دیتاهای مورد نیاز را طبق جدول زیر به آدرس https://paymentpol.com/webservice/rest/PaymentVerification از طریق متد POST ارسال کند

لیست داده هاي برگشتی در پاسخ به فرايند استعلام تراکنش ( Verify )

نمونه کد Callback و Verify کردن تراکنش

<?php
$MerchantID 	= 'XXXX-XXXX-XXXX-XXXXXXXXXXXXXXXXXXXXX';
$Amount 	= 1000;

if (isset($_POST['PaymentStatus']) && $_POST['PaymentStatus'] == 'OK')
{
$Authority 	= (isset($_POST['Authority']) && $_POST['Authority'] != "") ? $_POST['Authority'] : "";
$InvoiceID 	= (isset($_POST['InvoiceID']) && $_POST['InvoiceID'] != "") ? $_POST['InvoiceID'] : "";

$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, 'https://paymentpol.com/webservice/rest/PaymentVerification');
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type' => 'application/json'));
curl_setopt($curl, CURLOPT_POSTFIELDS, "MerchantID={$MerchantID}&Amount={$Amount}&Authority={$Authority}");
curl_setopt($curl, CURLOPT_TIMEOUT, 30);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$curl_exec = curl_exec($curl);
curl_close($curl);

$result = json_decode($curl_exec);

if (isset($result->Status) && $result->Status == 100)
{
echo 'Transation success. Amount : '. $result->Amount .' Toman AND RefID : '. $result->RefID;
} else {
echo (isset($result->Status) && $result->Status != "") ? $result->Status : "Error connecting to web service";
}
} else {
echo 'Transaction Canceled By User';
}
?>