ونداپرداخت ارائه‌دهنده راه‌حل‌های بانکی و خدمات تراکنشی

    منوی اصلی

  • مستندات وب سرویس
  • وردپرس
  • جوملا
  • فروشگاه ساز ها
  • مدیریت هاستینگ
  • انجمن ها
مقدمه
جهت مجهز کردن سایت و فروشگاه خودتان به سامانه پرداخت آنلاین ، ملزم به ارتباط با api سامانه میباشید .
پروتکل پیاده سازی این سامانه براساس JSON API میباشد که یکی از مزیت هایش استفاده ساده در تمامی زبان های برنامه نویسی میباشد .
کلیه پارامتر ها ارسالی و دریافتی به وبسرویس ، بر اساس فرمت json میباشد . همچنین کلیه دیتاهای ارسالی به وبسرویس باید بصورت POST شده باشند . الزامی به ارسال هدر application/json نیست .

فرآیند خرید :
برای انجام فرآیند خرید ، باید کاربر را در فروشگاه /سایتتان به مرحله پرداخت آنلاین برسانید و سپس به api وصل بشید
برای شروع فرآیند خرید باید به متد request متصل بشید و پارامترهای مربوطه را ارسال کنید ، چنانچه عملیات موفقیت آمیز باشد result برابر 1 برگشت داده میشود و همچنین کد پیگیری vprescode و فرم ارسال به درگاه بانک .
کد vprescode را در دیتابیس خود ذخیره کنید ، برای عملیات وریفای به این کد نیاز هست فرم html ارسال به بانک را در بخش مناسب نشان دهید تا کاربر با کلیک برروی دکمه پرداخت موجود در فرم به بانک هدایت شود و عملیات پرداخت را انجام دهد .

بعد از پرداخت کاربر به آدرس کال بکی که ست کرده ای برگشت داده میشود و همراه آن پارامترهایی از بانک فرستاده میشود در این مرحله باید شما به متد verify از وبسرویس متصل بشوید و پارامترهای الزامی این متد را وارد کرده و نتیجه را بررسی کنید .
پارامترهای الزامی شامل مبلغ خرید ، کد vprescode ، کد order_id که قبلا وارد کرده اید pin درگاه و همچنین کلیه پارامترهای دریافتی از بانک میباشد .
بعد از فراخوانی این متد چنانچه result برابر 1 بود یعنی عملیات با موفقیت انجام شده و مبلغ به حسابتان واریز شده است .
نکته مهم : چنانچه این متد را فراخوانی نکنید مبلغ بصورت خودکار بعد از چند دقیقه به حساب پرداخت کننده عودت میگردد .
متد request
این متد متد مرحله اول انجام تراکنش هست ، ابتدا این متد را فراخوانی کنید ،
پارامترالزامی|اختیاریمقادیر مجازمثالتوضیحات
pinالزامیstringgtd1u16d960522r809پین اتصال به درگاه ، از پنل کاربری در سایت در لیست درگاهها این پین را بردارید
priceالزامیnumber1000مبلغ پرداختی به تومان
callbackالزامیstringhttp://example.org/callback?id=1آدرس کال بک فروشگاه که باید منطبق با آدرس ثبت شده در داخل پنل کاربری باشد
order_idالزامیnumber1 تا 999999999شماره فاکتور اعلامی شما
descriptionاختیاریstring--توضیحاتی در رابطه با تراکنش که در پنل ثبت میگردد
nameاختیاریstring--نام پرداخت کننده
emailاختیاریstringinfo@example.orgایمیل پرداخت کننده ، جهت اطلاع رسانی
mobileاختیاریstring9180000000شماره موبایل پرداخت کننده ، جهت اطلاع رسانی
ipاختیاریstring127.0.0.1آی پی شخص پرداخت کننده ، جهت پیگیری

 $data_string = json_encode(array( 'pin'=> 'yourpin', 'price'=> '1000', 'callback'=> 'http://localhost/a_test/t12.php', 'order_id'=> '459652', 'email'=> 'buyer@example.org', 'description'=> 'test', 'name'=> 'username', 'tell'=> '09111111111', 'ip'=> '192.168.1.1', ));// use curl $ch = curl_init('https://vandapardakht.com/Request');curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, array( 'Content-Type: application/json', 'Content-Length: ' . strlen($data_string)) );curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 1);curl_setopt($ch, CURLOPT_TIMEOUT, 30);$result = curl_exec($ch);curl_close($ch);//result $json = json_decode($result,true);print_r($json);
بعد از فراخوانی این متد ، خروجی بصورت json برگشت داده میشود .
نمونه مثال برای تراکنش موفق
 { 
"result": 1,
"vprescode": "4528u16g14d960523r3191",
"form": "<form name='payment' action='someaction' method='POST'><input type='hidden' name='Refid' value='somevalue'><input type=submit value='Pay'><\/form>",
}
نمونه خروجی تراکنش ناموفق
 {
"result": -20,
}
متد verify
بعد از انجام دادن فرآیند پرداخت در صفحه پرداخت بانک ، کاربر به آدرس کال بک شما بازگشت داده میشود که همراه آن یک سری پارامتر از بانک ارسال میگردد . اسم این پارامترها و متد نحوه برگشت در خروجی bank_callback_details متد request توضیح داده شد . اما در هر صورت میتوانید کلیه پارامتر های POST و GET شده به کال بک سایت را ارسال کنید . بعد از فراخوانی متد verify چنانچه مقدار result برابر 1 باشد مبلغ به حسابتان افزوده میگردد در غیر اینصورت کد خطای لازم نشان داده میشود پارامترهایی که باید به متد verify ارسال کنید به شرح زیر است
پارامترالزامی|اختیاریمقادیر مجازمثالتوضیحات
pinالزامیstringgtd1u16d960522r809پین اتصال به درگاه ، از پنل کاربری در سایت در لیست درگاهها این پین را بردارید
priceالزامیnumber1000مبلغ پرداختی به تومان
order_idالزامیnumber1 تا 999999999شماره فاکتور اعلامی شما
vprescodeالزامیstring4528u16g14d960523r3191شناسه پیگیری vprescode که در مرحله request دریافت کرده اید
bank_returnالزامیjson {
"SaleReferenceId":"20170814113803",
"ResCode":"random_res_code_8",
"card_pan":"1111111111111111",
"State":"1"
}
لیست مقادیر ارسالی از سمت درگاه بانک به سمت کال بک شما

 $bank_return = $_POST + $_GET ;$data_string = json_encode(array ( 'pin' => 'gtd1u16d960522r810', 'price' => 1000, 'order_id' => 1, 'vprescode' => '4531u16g14d960523r4166', 'Bank_return'=>$return_bank, ));$ch = curl_init('https://vandapardakht.com/Verify');curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, array( 'Content-Type: application/json', 'Content-Length: ' . strlen($data_string)) );curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);curl_setopt($ch, CURLOPT_TIMEOUT, 30);curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 1);$result = curl_exec($ch);curl_close($ch);//result $json = json_decode($result,true);print_r($json);
مقادیر بازگشتی متد verify یک مقدار json به شرح زیر است .
در تراکنش موفق مقدار result برابر 1 میباشد .
تراکنش موفق :
 { "result": 1, }
تراکنش ناموفق
 { "result": 0, }
تراکنش خطا دار
 { "result": -31, }
توضیحات پارامترهای خروجی
پارامترنوعمثالتوضیحات
resultnumber1اگر برابر 1 باشد یعنی عملیات وریفای موفقیت آمیز اگر برابر صفر باشد یعنی تراکنش وریفای نشده و درصورت کسر مبلغ ، از طرف بانک بعد از چند دقیقه مبلغ مرجوع میگردد در صورتیکه کد خطا یک عدد منفی بود ، یعنی خطایی رخ داده است .

لیست خطاها
کد خطامعنی
-1پارامترهای ارسالی برای متد مورد نظر ناقص یا خالی هستند . پارمترهای اجباری باید ارسال گردد
-2دسترسی api برای شما مسدود است
-6عدم توانایی اتصال به گیت وی بانک از سمت وبسرویس
-9خطای ناشناخته
-20پین نامعتبر
-21ip نامعتبر
-22مبلغ وارد شده کمتر از حداقل مجاز میباشد
-23مبلغ وارد شده بیشتر از حداکثر مبلغ مجاز هست
-24مبلغ وارد شده نامعتبر
-26درگاه غیرفعال است
-27آی پی مسدود شده است
-28آدرس کال بک نامعتبر است ، احتمال مغایرت با آدرس ثبت شده
-29 آدرس کال بک خالی یا نامعتبر است
-30چنین تراکنشی یافت نشد
-31تراکنش ناموفق است
-32مغایرت مبالغ اعلام شده با مبلغ تراکنش
-35شناسه فاکتور اعلامی order_id نامعتبر است
-36پارامترهای برگشتی بانک bank_return نامعتبر است
-38تراکنش برای چندمین بار وریفای شده است
-39 تراکنش در حال انجام است

icon-plugins

Joombrifreelance

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Joombahjobs

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Digicom

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Vikevents

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Virtuemart

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

RSmembership

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

RSform

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

K2store

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Tinypayment

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Joomshopping

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Joombrifreelance

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

j2store

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

HikaShop

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Guru

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

fileSeller

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Eshop

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

DJClassifieds

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

Payplans

جوملا

1.0.1

پلاگین پرداخت

جهت استفاده در جوملا

icon-plugins

ووکامرس

وورد پرس

1.0.1

پلاگین پرداخت

جهت استفاده درفروشگاه ساز ووکامرس

woocommerce

VIPFileDownloads

VIPFileDownloads

3.2.1

پلاگین پرداخت

WordPress-VIPFileDownloads

woocommerce

PaidDownloads

PaidDownloads

3.0.4

پلاگین پرداخت

PaidDownloads

woocommerce

MyCred

MyCred

3.0.4

پلاگین پرداخت

MyCred

woocommerce

EDD

EDD

3.0.4

پلاگین پرداخت

EDD

woocommerce

Advancevip

Advancevip

3.0.4

پلاگین پرداخت

Advancevip

ساده و بدون هزینه / همه تراکنش‌ها و مشتریان‌شما دریک‌ حساب‌کاربری !