پیش نیازها

برای استفاده از این سرویس، نیاز است تا ابتدا از طریق پشتیبانی درخواست فعال سازی API را ارسال نمایید. در صورت فعال بودن API، برای تغییر توکن می توانید از طریق پنل اقدام نمایید

توکن API در Header درخواست با کلید Token می بایست ارسال شود.

تمامی ورودی ها به صورت JSON می باشد.

تمامی خروجی ها از نوع JSON می‌باشد.

تمامی درخواست ها با متد POST دریافت می شود.

دریافت فایل خروجی Postman Collection: دریافت

آدرس ابتدایی تمامی درخواست ها با https://seasharj.ir/api/v3/partners آغاز می‌شود.

استعلام موجودی کیف پول

https://seasharj.ir/api/v3/partners/general/credit

                

                Response Body:
                
    {
        "credit": 250000
    }

بدنه پاسخ

پارامتر	نوع	توضیحات
credit	Number	موجودی کیف پول

لیست سرویس ها

https://seasharj.ir/api/v3/partners/services

                

                Response Body:
                
    [
        {
            "title": "پرداخت قبض داخلی ایران",
            "slug": "int_general_bill",
            "ordering": "active"
        },
        {
            "title": "اینترنت بین الملل",
            "slug": "data",
            "ordering": "active"
        },
        {
            "title": "شارژ مستقیم بین الملل",
            "slug": "mobilerefills",
            "ordering": "active"
        },
        {
            "title": "شارژ مستقیم داخلی ایران",
            "slug": "int_direct",
            "ordering": "active"
        },
        {
            "title": "اینترنت داخلی ایران",
            "slug": "int_internet",
            "ordering": "active"
        }
    ]

بدنه پاسخ

پارامتر	نوع	توضیحات
title	String	عنوان
slug	String	کلید
ordering	String	وضعیت سفارشگیری - (active: فعال, inactive: غیرفعال)

لیست کشورها

https://seasharj.ir/api/v3/partners/services/{service_slug}/countries

                

                Response Body:
                
    {
        "service": {
            "title": "شارژ بین الملل",
            "slug": "mobilerefills",
            "ordering": "active"
        },
        "countries": [
            {
                "id": "1065",
                "title_fa": "آذربایجان",
                "title_en": "Azerbaijan",
                "iso_code": "AZE",
                "unit_fa": "منات",
                "unit_en": "AZN",
                "prefix": "+994"
            },
            {
                "id": "1255",
                "title_fa": "آروبا",
                "title_en": "Aruba",
                "iso_code": "ABW",
                "unit_fa": "فلورین آروبا",
                "unit_en": "ABW",
                "prefix": "+297"
            }
        }
    }

بدنه پاسخ

service : آبجکت اطلاعات سرویس

پارامتر	نوع	توضیحات
title	String	عنوان
slug	String	کلید
ordering	String	وضعیت سفارشگیری - (active: فعال, inactive: غیرفعال)

countries : لیستی از آبجکت ها - لیست کشورها

پارامتر	نوع	توضیحات
id	Number	شناسه
title_fa	String	عنوان فارسی
title_en	String	عنوان انگلیسی
prefix	String	پیش شماره
unit_fa	String	واحد ارز - فارسی
unit_en	String	واحد ارز - انگلیسی
iso_code	String	کد ISO کشور

لیست اپراتورها

https://seasharj.ir/api/v3/partners/services/{service_slug}/operators

                Request Body:
                
    {
        "country": 1055
    }
                

                Response Body:
                
    [
        {
            "id": "1602",
            "title": "Afghan Wireless Afghanistan",
            "slug": "afghan-wireless-afghanistan"
        },
        {
            "id": "1545",
            "title": "Etisalat Afghanistan",
            "slug": "etisalat-afghanistan"
        },
        {
            "id": "1550",
            "title": "MTN Afghanistan",
            "slug": "mtn-afghanistan"
        },
        {
            "id": "1460",
            "title": "Roshan Afghanistan",
            "slug": "roshan-afghanistan"
        },
        {
            "id": "1751",
            "title": "Salaam Afghanistan",
            "slug": "salaam-afghanistan"
        }
    ]

بدنه درخواست

پارامتر	نوع	توضیحات
country	Number	شناسه کشور

بدنه پاسخ

پارامتر	نوع	توضیحات
id	Number	شناسه اپراتور
title	String	نام اپراتور
slug	String	کلید اپراتور

اطلاعات اپراتور

https://seasharj.ir/api/v3/partners/services/{service_slug}/operator

                Request Body:
                
    {
        "operator": 1602
    }
                

                Response Body:
                
    {
        "operator": {
            "id": "1602",
            "title": "Afghan Wireless Afghanistan",
            "slug": "afghan-wireless-afghanistan",
            "cellphone": "active",
            "min": 50,
            "max": 5000,
            "step": 0.01,
            "unit_fa": "افغانی",
            "unit_en": "AFN",
            "manually": "active",
            "stock": true,
            "country": {
                "id": "1055",
                "title_fa": "افغانستان",
                "title_en": "Afghanistan",
                "iso_code": "AFG",
                "unit_fa": "افغانی",
                "unit_en": "AFN",
                "prefix": "+93"
            }
        },
        "packages": [
            {
                "id": "49302",
                "name": "20 AED",
                "amount": 20,
                "description": "20 AED",
                "validity": " ",
                "internet_type": "",
                "sim_type": ""
            },
            {
                "id": "49301",
                "name": "50 AED",
                "amount": 50,
                "description": "50 AED",
                "validity": " ",
                "internet_type": "",
                "sim_type": ""
            }
        ]
    }

بدنه درخواست

پارامتر	نوع	توضیحات
operator	Number	شناسه اپراتور

بدنه پاسخ

operator : اطلاعات تکمیلی اپراتور

پارامتر	نوع	توضیحات
id	Number	شناسه اپراتور
title	String	نام اپراتور
slug	String	کلید اپراتور
cellphone	String	ضروری بودن ارسال شماره تلفن همراه - (active: فعال, inactive: غیرفعال)
image	String	لینک تصویر اپراتور
min	Number	حداقل مبلغ
max	Number	حداکثر مبلغ
step	Number	گام مبلغ
unit_fa	String	واحد ارز - فارسی
unit_en	String	واحد ارز - انگلیسی
manually	String	انتخاب دستی بین بازه مشخص شده - (active: فعال, inactive: غیرفعال) - در صورت فعال بودن این گزینه، هنگام ثبت سفارش مقدار amount ارسال گردد. مقدار amount باید در بازه min و max باشد. در صورت غیرفعال بودن این گزینه، هنگام ثبت سفارش مقدار package_id باید ارسال گردد. package_id از میان بسته هایی که در خروجی دریافت شده قابل تشخیص است.
stock	Boolean	موجود بودن اپراتور : ممکن است برخی از اپراتورها در برخی موارد، از طرف تامین کنندگان موجود یا ناموجود گردد. لازم به ذکر است اپراتورهایی که false هستن قابلیت ثبت سفارش را ندارند.
country	Object	داده های مربوط به کشور

packages : بسته های اپراتور به صورت یک لیست از آبجکت بسته، شامل id,name,amount,...

استعلام قبوض

https://seasharj.ir/api/v3/partners/services/{service_slug}/check

                

                Response Body:
                
    {
        "bill_id": "x",
        "pay_id": "x"
    }

بدنه پاسخ

پارامتر	نوع	توضیحات
type_en	String	عنوان انگلیسی قبض
type_fa	String	عنوان فارسی قبض
amount	Number	مبلغ قبض

ثبت سفارش

https://seasharj.ir/api/v3/partners/services/{service_slug}/ordering

                Request Body:
                
    // شارژ مستقیم بین الملل با قیمت معین
    
    {
        "country": 1055,
        "operator": 137,
        "amount": 20,
        "cellphone": "79*******"
    }
                

    // شارژ مستقیم بین الملل  یا اینترنت بین الملل طبق بسته انتخابی

                
    {
        "country": 1055,
        "operator": 137,
        "package_id": 1,
        "cellphone": "79*******"
    }
                

    // شارژ مستقیم داخلی طبق بسته انتخابی

                
    {
        "country": 1281,
        "operator": 1305,
        "cellphone": "09031111111",
        "package_id": 12101,
        "charge_type": "normal"
    }
                

    // اینترنت داخلی طبق بسته انتخابی 

                
    {
        "country": 1281,
        "operator": 1310,
        "cellphone": "09031111111",
        "package_id": 599,
        "sim_type": "credit",
        "internet_type": "monthly",
    }
                

    // پرداخت قبض با استفاده از شناسه قبض و شناسه پرداخت 

                
    {
        "bill_id": 2123121231321,
        "pay_id": 21321321321231
    }
                


                Response Body:
                
    {
        "request_id": 123143
    }

بدنه درخواست

پارامتر	نوع	سرویس ها	توضیحات
operator	Number	شارژ مستقیم بین اللملل اینترنت بین اللملل شارژ داخلی ایران اینترنت داخلی ایران	شناسه اپراتور
country	Number	شارژ مستقیم بین اللملل اینترنت بین اللملل شارژ داخلی ایران اینترنت داخلی ایران	شناسه کشور
amount	Number	شارژ مستقیم بین اللملل اینترنت بین اللملل شارژ داخلی ایران اینترنت داخلی ایران	مبلغ : تنها در صورتی که در اطلاعات اپراتور گزینه manually برابر با active باشد.
package_id	Number	شارژ مستقیم بین اللملل اینترنت بین اللملل شارژ داخلی ایران اینترنت داخلی ایران	شناسه بسته : تنها در صورتی که در اطلاعات اپراتور گزینه manually برابر با inactive باشد.
cellphone	String	شارژ مستقیم بین اللملل اینترنت بین اللملل شارژ داخلی ایران اینترنت داخلی ایران	شماره تلفن همراه - تنها در صورتی که در اطلاعات اپراتور به عنوان فیلد ضروری در نظر گرفته شده باشد
charge_type	String	شارژ داخلی ایران	نوع شارژ - تنها برای سرویس شارژ مستقیم داخلی، می تواند یکی از این مقادیر باشد (normal برای سیم کارت های اعتباری,amazing برای شارژ شگفت انگیز,permanent برای سیم کارت های دائمی)
sim_type	String	اینترنت داخلی ایران	نوع سیم کارت - تنها برای سرویس اینترنت داخلی، می تواند یکی از این مقادیر باشد (credit برای سیم کارت های اعتباری,permanent برای سیم کارت های دائمی)
internet_type	String	اینترنت داخلی ایران	دوره زمانی اینترنت - تنها برای سرویس اینترنت داخلی، طبق مقدار فیلد internet_type بسته انتخابی - این مقدار در خروجی بسته های اپراتور قابل مشاهده است
mnp	Number	اینترنت داخلی ایران	سیم کارت ترابرد شده - تنها برای سرویس اینترنت داخلی، این فیلد تنها زمانی ارسال می گردد که سیم کارت کاربر ترابرد شده باشد، در صورتی که سیم کارت ترابرد شده بود مقدار 1 ارسال گردد، در غیر این صورت نیازی به ارسال این مقدار نمی باشد.
bill_id	String	پرداخت قبض داخلی ایران	شناسه قبض - تنها برای سرویس پرداخت قبض داخلی ایران
pay_id	String	پرداخت قبض داخلی ایران	شناسه پرداخت - تنها برای سرویس پرداخت قبض داخلی ایران

بدنه پاسخ

پارامتر	نوع	توضیحات
request_id	Number	شناسه سفارش - جهت پیگیری و دستور پرداخت

دریافت جزئیات سفارش

https://seasharj.ir/api/v3/partners/requests/{request_id}

                Response Body:
                
    {
        "id": "690790",
        "country": {
            "id": "1147",
            "title_fa": "امارات متحده عربی",
            "title_en": "United Arab Emirates",
            "iso_code": "ARE",
            "unit_fa": "درهم",
            "unit_en": "AED",
            "prefix": "+971"
        },
        "operator": {
            "id": "1784",
            "title": "Virgin Mobile United Arab Emirates"
        },
        "package": {
            "id": "49302",
            "name": "20 AED",
            "amount": 20,
            "validity": " "
        },
        "cellphone": false,
        "charge": {
            "amount": 20,
            "unit_fa": "درهم",
            "unit_en": "AED"
        },
        "price": {
            "amount": 367823,
            "unit_fa": "تومان",
            "unit_en": "IRT"
        },
        "result": {
            "pin": null,
            "code": null,
            "serial": null,
            "url": null,
            "rsp": null
        },
        "create_date": 1727774902,
        "expire_date": 1727775204,
        "status": "payment"
    }

بدنه پاسخ

پارامتر	نوع	توضیحات
id	Number	شناسه سفارش
country	Object	کشور
operator	Object	اپراتور
package	Object	بسته
cellphone	String	تلفن همراه
charge	Object	مبلغ درخواستی برای شارژ
price	Object	مبلغ قابل پرداخت
result	Object	نتیجه سفارش
create_date	Number	تاریخ ایجاد سفارش - UnixTimestamp
expire_date	Number	تاریخ انقضاء سفارش - UnixTimestamp
status	String	وضعیت سفارش

وضعیت سفارشات می‌تواند به صورت زیر باشد

payment: در انتظار پرداخت
pending: در حال انجام
success: انجام شده
unsuccess: ناموفق

تایید و پرداخت سفارش

https://seasharj.ir/api/v3/partners/requests/{request_id}/confirm


                Response Body:
                
    {
        "payment": true
    }

بدنه پاسخ

پارامتر	نوع	توضیحات
payment	Bool	وضعیت پرداخت - در صورت true بودن سفارش شما با موفقیت پرداخت شده است

توجه

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

خطاها

                Response Body:
                
    {
        "error": {
            "message": "متن خطا",
            "errors": []
        }
    }

    // OR

    {
        "error": "متن خطا"
    }

تمامی Requestهای موفق HTTP STATUS 200 را به همراه Response نمایش می‌دهد. در صورتی که Request ارسالی STATUS به غیر از 200 داشت، خطایی رخ داده است. به صورت کلی در صورت بروز هرگونه خطا پارامتری با نام error در خروجی نمایش داده خواهد شد.