وب سرویس درگاه پرداخت واسط

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

API به برنامه نویسان این اجاره رو میدهد تا اطلاعات را بین پلتفرم های مختلف از طریق درخواست های HTTP یا HTTPS منتقل کنند.

REST هم یه روش بسیار ساده و هم محبوبترین و پر کاربرد ترین روش برای استفاده از APIهست.

epooli.com این امکان رو به برنامه نویسان میدهد تا با استفاده از REST وب سایت خود را به درگاه پرداخت متصل نمایند.

نکته : تمامی داده های برگشتی از epooli.com به صورت json می باشد.

نیازمندی سایت شما برای اتصال به سیستم پرداخت epooli.com فقط فعال بودن تابع curl بوده که در اکثر سرور ها این تابع فعال می باشد. برای مطمئن شدن از فعال بودن این تابع با مدیر سرور خود تماس بگیرید.

 

مرحله اول ( ارسال داده ها )

اولین مرحله برای اتصال به درگاه پرداخت epooli.com ارسال داده ها از طریق متد زیر هستش.

ساختار URL :

https://epooli.com/ws/pg/send

داده های ارسالی :

نام فیلد نوع فیلد توضیحات
api string API Key دریافتی شما از epooli.com
amount integer مبلغ تراکنش به صورت ریالی و بزرگتر یا مساوی 1000
redirect string آدرس بازگشتی به صورت urlencode ، که باید با آدرس درگاه پرداخت تایید شده بر روی یک دامنه باشد
description string توضیحات پرداخت
factorNumber string شماره فاکتور

داده های دریافتی :

در صورتی که اطلاعات ارسالی صحیح باشد :

{
    "status" : 1,
    "transId": شماره تراکنش
}

در صورت بروز خطا :

}
    "status"       : 0,
    "errorCode"    : کد خطا,
    "errorMessage" : متن پیام خطا
{

جدول خطاها به شرح زیر می باشد :

کد خطا متن خطا
-10 اطلاعات ارسالی ناقص است
-1 درگاه پرداختی با api ارسالی یافت نشد و یا غیر فعال می باشد
-21 درگاه منتظر تایید و حداکثر تراکنش 10000 ریال می باشد
-20 درگاه فعال نمی باشد
-2 مبلغ نامعتبر می باشد
-8 این شماره فاکتور قبلا ارسال شده است
-9 خطای ثبت تراکنش

مرحله دوم ( انتقال به صفحه پرداخت )

در صورتی که در مرحله قبل (ارسال داده ها) ، اطلاعات ارسالی صحیح باشد و دو مقدار status و transId رو به عنوان پاسخ از Epooli.com دریافت کردید باید کاربر رو به آدرس زیر انتقال دهید. نکته : به جای {transId} مقدار transId دریافتی رو قرار بدین

https://epooli.com/ws/pg/pay/{transId{

مرحله سوم ( بازگشت به سایت پذیرنده پس از پرداخت )

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

نام فیلد نوع فیلد توضیحات
status integer وضعیت تراکنش : مقدار 1 موفق و مقدار 0 ناموفق
transId integer شماره تراکنش
factorNumber string شماره فاکتور ارسالی توسط شما در مرحله اول
cardNumber string شماره کارتی که تراکنش با آن انجام شده است
message string متن پیام

مرحله چهارم ( وریفای یا تایید تراکنش )

در صورتی که در مرحله قبل مقدار فیلد status برابر یا عدد صحیح 1 باشه باید برای تایید تراکنش (وریفای) و دریافت مبلغ تراکنش از طریق متد زیر اقدام کنید.

توجه ! درصورت عدم وریفای تراکنش وجه پرداختی به حساب پرداخت کننده بعد از 30 دقیقه برگشت داده خواهد شد.

ساختار URL :

https://epooli.com/ws/pg/verify

داده های ارسالی :

نام فیلد نوع فیلد توضیحات
api string API Key دریافتی شما از Epooli.com
transId integer transId دریافتی از مرحله سوم

داده های دریافتی :

در صورتی که اطلاعات ارسالی صحیح باشد و تراکنش تایید (وریفای) شود :

{ "status": 1, "amount": مبلغ تراکنش, "trackID": شماره پیگیری }

در صورت بروز خطا :

{
    "status"       : 0,
    "errorCode"    : کد خطا,
    "errorMessage" : متن پیام خطا
}

جدول خطاها به شرح زیر می باشد :

کد خطا متن خطا
-10 اطلاعات ارسالی ناقص است
-1 درگاه پرداختی با api ارسالی یافت نشد و یا غیر فعال می باشد
-8 تراکنش یافت نشد
-74 تراکنش قبلا تایید شده است
-5 تراکنش انجام نشده است
آخرین بروزرسانی:
06-دی(10)-1397
دانلود تست وب سرویس php

دانلود اپلیکیشن

بزودی در سیستم عامل‌های Android, IOS و Windows Phone

سریع ترین و آسان ترین روش خرید شارژ و پرداخت قبض