خرید شارژ

برای خرید شارژ ابتدا باید محصول مورد نظر خود را از api product یا فیلتر ها بگیرید به عنوان مثال برای خرید شارژ اعتباری با مبلغ دلخواه که بین ۵۰۰۰ ریال تا ۲٫۰۰۰٫۰۰۰ ریال از این محصول استفاده می کنیم

Idempotency چیست ؟

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

پس با توجه به توضیحات بالا برای جلوگیری از درخواست های تکراری شما می بایست برای هر درخواست یک کد یکتا تولید کنید و حتما ارسال کنید در صورت عدم ارسال شارژ یا بسته شما انجام نخواهد شد

نحوه ارسال Idempotency هم به صورت هدر و با کلید Idempotency-Key می باشد

نحوه خرید شارژ شگفت انگیز و شورانگیز

برای شگفت انگیز ایرانسل سه محصول زیر تعریف شده است :
763 - شارژ ۵۰,۰۰۰ ریالی شگفت انگیز
764 - شارژ ۲۰۰,۰۰۰ ریالی شگفت انگیز
765 - شارژ ۱,۰۰۰,۰۰۰ ریالی شگفت انگیز


برای خرید شارژ شور انگیز رایتل این محصول:
766 - شارژ از ۱,۰۰۰ تا ۲,۰۰۰,۰۰۰ ریالی شور انگیز رایتل

نمونه محصول

{
    "id": 62,
    "name": "شارژ مستقیم ایرانسل - مبلغ دلخواه",
    "name_en": null,
    "description": "شارژ مستقیم ایرانسل - مبلغ دلخواه",
    "description_full": null,
    "sku": null,
    "price": 5000,
    "second_price": 2000000,
    "showable_price": null,
    "type": "cell_direct_charge",
    "minimum_sale": null,
    "dimension": null,
    "score": 0,
    "status": 1,
    "options": null,
    "deliverable": 0,
    "third_party_id": null,
    "capacity": null,
    "period": null,
    "sim_card_type": "credit",
    "operator_id": 2,
    "profile_id": null,
    "order": 62,
    "created_at": null,
    "updated_at": null,
    "categories": []
}
POST/api/top-up

خرید شارژ

برای خرید شارژ فیلد های زیر را ارسال کنید
و همچنین برای تست این api بدون رفتن به اپراتور و کم شدن از حساب شما می توانید از محیط تست ما استفاده کنید
برای این امر کافیست پارامتر fake_response را true برای موفق و false برای جواب نا موفق ارسال کنید
برای اطلاعات بیشتر به صفحه محیط تست مراجعه کنید در کنار تمامی فیلد های ضروری علامت * قرار گرفته است

  • Name
    product_id *
    Type
    string
    Description

    id عددی محصول که قبل تر توضیح دادیم از api محصولات دریافت و در این فیلد ارسال میکنید. ایدی عددی محصول در body ارسال شود
    که به صورت string باید ارسال شود

  • Name
    mobile *
    Type
    string
    Description

    شماره موبایل مورد نظر برای خرید شارژ که حتما باید با این فرمت باشد :
    98902XXXXXXX

  • Name
    price *
    Type
    string
    Description

    مبلغ پرداختی
    که به صورت string باید ارسال شود

  • Name
    webservice_code *
    Type
    string
    Description

    code مورد نیاز شما برای ذخیره سازی و بررسی و پیگیری درخواست ها

  • Name
    fake_response
    Type
    boolean
    Description

    اگر نیاز دارید نمایش جواب موفق ببینید این فیلد را true ارسال کنید توجه داشته باشید این مقدار فقط در محیط تست با آدرس https://dev.testesaj.ir معتبر می باشد

درخواست

POST
/api/top-up
curl -X POST https://gateway.esaj.ir/api/top-up \
-H "Authorization: Bearer {token}" \
-H "Idempotency-Key: YOUR_RANDOM_IDENPOTENCY" \
-F mobile=989021234567 \
-F price=5000 \
-F product_id=62 \
-F webservice_code="YOUR_CODE"

نتیجه درخواست

{
    "message": "successful",
    "status": true,
    "mobile": "98912##########",
    
}

اطلاعات این صفحه مفید بود ؟