منوی اصلی

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

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

بعد از پرداخت کاربر به آدرس کال بکی که ست کرده ای برگشت داده میشود و همراه آن پارامترهایی از بانک فرستاده میشود در این مرحله باید شما به متد verify از وبسرویس متصل بشوید و پارامترهای الزامی این متد را وارد کرده و نتیجه را بررسی کنید .
پارامترهای الزامی شامل مبلغ خرید ، کد vprescode ، کد order_id که قبلا وارد کرده اید pin درگاه و همچنین کلیه پارامترهای دریافتی از بانک میباشد .
بعد از فراخوانی این متد چنانچه result برابر 1 بود یعنی عملیات با موفقیت انجام شده و مبلغ به حسابتان واریز شده است .
نکته مهم : چنانچه این متد را فراخوانی نکنید مبلغ بصورت خودکار بعد از چند دقیقه به حساب پرداخت کننده عودت میگردد .
متد request
این متد متد مرحله اول انجام تراکنش هست ، ابتدا این متد را فراخوانی کنید ،
پارامتر الزامی|اختیاری مقادیر مجاز مثال توضیحات
pin الزامی string gtd1u16d960522r809 پین اتصال به درگاه ، از پنل کاربری در سایت در لیست درگاهها این پین را بردارید
price الزامی number 1000 مبلغ پرداختی به تومان
callback الزامی string http://example.org/callback?id=1 آدرس کال بک فروشگاه که باید منطبق با آدرس ثبت شده در داخل پنل کاربری باشد
order_id الزامی number 1 تا 999999999 شماره فاکتور اعلامی شما
description اختیاری string -- توضیحاتی در رابطه با تراکنش که در پنل ثبت میگردد
name اختیاری string -- نام پرداخت کننده
email اختیاری string info@example.org ایمیل پرداخت کننده ، جهت اطلاع رسانی
mobile اختیاری string 9180000000 شماره موبایل پرداخت کننده ، جهت اطلاع رسانی
ip اختیاری string 127.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 الزامی string gtd1u16d960522r809 پین اتصال به درگاه ، از پنل کاربری در سایت در لیست درگاهها این پین را بردارید
price الزامی number 1000 مبلغ پرداختی به تومان
order_id الزامی number 1 تا 999999999 شماره فاکتور اعلامی شما
vprescode الزامی string 4528u16g14d960523r3191 شناسه پیگیری 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,
                  }
                
              
توضیحات پارامترهای خروجی
پارامتر نوع مثال توضیحات
result number 1 اگر برابر 1 باشد یعنی عملیات وریفای موفقیت آمیز اگر برابر صفر باشد یعنی تراکنش وریفای نشده و درصورت کسر مبلغ ، از طرف بانک بعد از چند دقیقه مبلغ مرجوع میگردد در صورتیکه کد خطا یک عدد منفی بود ، یعنی خطایی رخ داده است .

لیست خطاها
کد خطا معنی
-1 پارامترهای ارسالی برای متد مورد نظر ناقص یا خالی هستند . پارمترهای اجباری باید ارسال گردد
-2 دسترسی api برای شما مسدود است
-6 عدم توانایی اتصال به گیت وی بانک از سمت وبسرویس
-9 خطای ناشناخته
-20 پین نامعتبر
-21 ip نامعتبر
-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

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