خرید شارژ
برای خرید شارژ ابتدا باید محصول مورد نظر خود را از api product یا فیلتر ها بگیرید به عنوان مثال برای خرید شارژ اعتباری با مبلغ دلخواه که بین ۵۰۰۰ ریال تا ۲٫۰۰۰٫۰۰۰ ریال از این محصول استفاده می کنیم
Idempotency چیست ؟
به معنای این است که شما می توانید یک درخواست را چندین بار ارسال کنید و در صورت موفقیت یا عدم موفقیت تراکنش، نتیجه همان خواهد بود. به عنوان مثال اگر شما یک درخواست خرید شارژ را ارسال کنید و به هر دلیلی پاسخ موفق دریافت نکنید، می توانید همان درخواست را دوباره ارسال کنید و نتیجه همان خواهد بود.
پس با توجه به توضیحات بالا برای جلوگیری از درخواست های تکراری شما می بایست برای هر درخواست یک کد یکتا تولید کنید و حتما ارسال کنید در صورت عدم ارسال شارژ یا بسته شما انجام نخواهد شد
نحوه ارسال Idempotency هم به صورت هدر و با کلید Idempotency-Key می باشد
در صورت عدم ارسال Idempotency در خواست شما پردازش و انجام نخواهد شد
نحوه خرید شارژ شگفت انگیز و شورانگیز
برای شگفت انگیز ایرانسل سه محصول زیر تعریف شده است :
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": []
}
خرید شارژ
برای خرید شارژ فیلد های زیر را ارسال کنید
و همچنین برای تست این api بدون رفتن به اپراتور و کم شدن از حساب شما می توانید از محیط تست ما استفاده کنید
برای این امر کافیست پارامتر fake_response را true برای موفق و false برای جواب نا موفق ارسال کنید
برای اطلاعات بیشتر به صفحه محیط تست مراجعه کنید
در کنار تمامی فیلد های ضروری علامت * قرار گرفته است
برای اطمینان از خرید خود در صورت پیش آمدن خطاهای احتمالی می توانید به این صفحه وضعیت تراکنش مراجعه کنید
برای خرید شارژ شاتل موبایل مبلغ ارسالی باید حتما به علاوه ۱۰ درصد مالیت بر ارزش افزوده شود و بعد ارسال شود
مثال :
۱۰,۰۰۰ ریال + ۱۰ درصد= ۱۱,۰۰۰ ریال
نکته مهم:
در این سیستم sim_card_type
credit => اعتباری
permanent => دائمی
که شما با توجه به سیم کارت وارد شده و انتخاب کاربر محصول درست را نمایش دهید.
- 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 معتبر می باشد
درخواست
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##########",
}