وبسرویس
درخواست های وبسرویس به صورت RESTFUL می باشد و میتوانید به صورت POST یا GET ارسال نمایید.
مرحله اول : وبسرويس ايجاد فاکتور
آدرس :
https://sepordeh.com/merchant/invoices/add
نام پارامتر | وضعيت | نوع داده | نمونه | شرح |
merchant | اجباري | string | KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl | مرچنت را بايد در بخش کسب و کار ها از داخل پنل برداريد |
amount | اجباري | number | 150000 | مبلغ فاکتور به تومان |
callback | اجباري | string | http://website.com/callback | آدرس بازگشت بعد از اتمام عمليات پرداخت |
description | اختياري | string | خريد گوشي موبايل | توضيحات در مورد فاکتور |
orderId | اختياري | number | 14886 | شماره سفارش در سیستم شما (حداکثر 20 رقمی) |
پاسخ وبسرويس ايجاد فاکتور (JSON) :
{
"status": 200, // وضعیت 200 به معنای موفقیت آمیز بودن ایجاد فاکتور می باشد
"message": "add completed",
"information": {
"invoice_id": 4 // این عدد شماره فاکتور ایجاد شده می باشد که باید ذخیره نمایید
}
}
مرحله دوم : ارجاع به صفحه پرداخت
آدرس اول :
https://sepordeh.com/merchant/invoices/pay/id:{{invoice_id}}
سلام مقدار {{invoice_id}} را با شماره فاکتور دریافتی در مرحله قبل جایگزین کنید.
آدرس دوم :
https://sepordeh.com/merchant/invoices/pay/automatic:true/id:{{invoice_id}}
در صورتی که میخواهید کاربر بدون مشاهده فاکتور و مستقیما وارد درگاه پرداخت شود از آدرس دوم استفاده کنید.
مرحله سوم:بازگشت به آدرس callback
آدرس:
http://website.com/callback?authority={{authority}}&&orderId={{orderId}}
هنگام بازگشت به آدرس callback دو پارامتر authority و orderId ارسال میگردد (توسط متد GET)
مرحله چهارم (پایانی) : وبسرويس تایید پرداخت
درصورتی که تایید پرداخت صورت نگیرد مبلغ به حساب پرداخت کننده برگشت خواهد خورد.
آدرس :
https://sepordeh.com/merchant/invoices/verify
نام پارامتر | وضعيت | نوع داده | نمونه | شرح |
merchant | اجباري | string | KnIT45OvAnd1584271146:8zN9iO1Y11tg6LVl | مرچنت را بايد در بخش کسب و کار ها از داخل پنل برداريد |
authority | اجباري | number | 35684 | این مقدار در هنگام بازگشت از صفحه پرداخت به صورت GET ارسال میگردد |
{
"status": 200, // وضعیت 200 به معنای موفقیت آمیز بودن پرداخت می باشد
"message": "paid",
"information": {
"invoice_id": 4 ,
"card": "6104********4510" // شماره کارت پرداخت کننده می باشد
}
}