مستندات برنامه نویسی درگاه‌های پرداخت میلیونا

مقدمه:

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

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

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

 

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

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

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

توجه داشته باشید که می توانید پیگیری تراکنش را قبل از مرحله سوم نیز انجام دهید.

توجه داشته باشید در صورت عدم تایید تراکنش (مرحله سوم) پس از گذشت حداکثر 72 ساعت وجه پرداختی به حساب مبدا بازگشت داده خواهد شد.

 

شروع فرآیند پرداخت:

 

مرحله اول (دریافت توکن پرداخت):

 

 

مقادیر ارسالی:

# نام پارامتر نوع پارامتر اجباری / اختیاری
1 terminal string اجباری
2 amount integer اجباری
3 mobile string اختیاری
4 national_code string اختیاری
5 callback_url string اجباری
6 order_id string اختیاری
7 card_no string اختیاری
8 description string اختیاری

 

terminal: این مقدار بعد از دریافت ترمینال در پنل کاربری شما قابل مشاهده خواهد بود.

amount: مبلغ تراکنش می بایست به تومان ارسال شود.

mobile: در صورت ارسال شماره موبایل پرداخت کننده، کاربر قادر خواهد بود شماره کارت های ذخیره شده خود را در درگاه پرداخت مشاهده نماید.

national_code: در صورت ارسال کدملی پرداخت کننده، شماره کارت پرداخت کننده می بایست متعلق به کد ملی ارسالی باشد.

order_id: در صورت استفاده شماره سفارش می توانید از این شماره در پیگیری تراکنش ها استفاده نمایید.

card_no: در صورت ارسال شماره کارت، کاربر تنها قادر به پرداخت وجه با آن شماره کارت خواهد بود.

description: توضیحات ارسالی در پنل کاربری میلیونا به شما نمایش داده خواهد شد.

 

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

# نام پارامتر نوع پارامتر توضیحات
1 token string توکن یکتا تراکنش به طول 36 کاراکتر
2 request_id string شناسه یکتا تراکنش به طول 20 کاراکتر جهت پیگیری تراکنش

 

مرحله دوم (هدایت کاربر به صفحه پرداخت):

 

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

 

 

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

 

# نام پارامتر نوع پارامتر توضیحات
1 token string توکن یکتا تراکنش به طول 36 کاراکتر
2 status string شامل مقدار OK یا NOK

 

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

 

مرحله سوم (تایید تراکنش):

 

 

مقادیر ارسالی:

# نام پارامتر نوع پارامتر اجباری / اختیاری
1 terminal string اجباری
2 token string اجباری

 

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

# نام پارامتر نوع پارامتر توضیحات
1 token string توکن یکتا تراکنش به طول 36 کاراکتر
2 amount integer مبلغ تراکنش
2 request_id string شناسه یکتا تراکنش به طول 20 کاراکتر
3 order_id string شماره سفارش ارسال از سمت پذیرنده
4 wage integer مبلغ کارمزد به تومان
5 card_number string شماره کارت پرداخت کننده
6 mobile string شماره موبایل پرداخت کننده در صورت ارسال
7 national_code string کد ملی پرداخت کننده در صورت ارسال
8 paid_at date تاریخ انجام تراکنش
9 description string توضیحات پذیرنده
10 status integer وضعیت تراکنش

 

مرحله چهارم (پیگیری تراکنش):

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

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