خرید بسته اینترنت
همانند خرید شارژ ابتدا محصول خود را از product یا filter بیاورید و بعد اطلاعات را تکمیل کنید
نحوه خرید بسته همانند شارژ برای تمامی اپراتور ها به (بجز شاتل موبایل) صورت یکسان اتفاق می افتد
Idempotency چیست ؟
به معنای این است که شما می توانید یک درخواست را چندین بار ارسال کنید و در صورت موفقیت یا عدم موفقیت تراکنش، نتیجه همان خواهد بود. به عنوان مثال اگر شما یک درخواست خرید شارژ را ارسال کنید و به هر دلیلی پاسخ موفق دریافت نکنید، می توانید همان درخواست را دوباره ارسال کنید و نتیجه همان خواهد بود.
پس با توجه به توضیحات بالا برای جلوگیری از درخواست های تکراری شما می بایست برای هر درخواست یک کد یکتا تولید کنید و حتما ارسال کنید در صورت عدم ارسال شارژ یا بسته شما انجام نخواهد شد
نحوه ارسال Idempotency هم به صورت هدر و با کلید Idempotency-Key می باشد
در صورت عدم ارسال Idempotency در خواست شما پردازش و انجام نخواهد شد
نمونه محصول
{
"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 برای جواب نا موفق ارسال کنید
در صورتی که فرآیند خرید مشکلی در آن وجود نداشته باشد جواب شما با کد ۲۰۰ برمیگردد برای تشخسص خرید موفق یا ناموفق به فیلد status توجه کنید
برای خرید بسته شاتل موبایل مبلغ ارسالی باید حتما به علاوه ۱۰ درصد مالیت بر ارزش افزوده شود و بعد ارسال شود
مثال :
۱۰,۰۰۰ ریال \
- ۱۰ درصد
= ۱۱,۰۰۰ ریال
در صورت بروز هرگونه خطای احتمالی در فرآیند خرید شما می توانید با webservice_code وضعیت تراکنش خود را پیگیری کنید برای اطلاعات بیشتر به صفحه وضعیت تراکنش مراجعه کنید
نکته مهم:
در این سیستم sim_card_type
credit => اعتباری
permanent => دائمی
که شما با توجه به سیم کارت وارد شده و انتخاب کاربر محصول درست را نمایش دهید.
- Name
product_id *- Type
- string
- Description
ایدی عددی محصول در body ارسال شود به صورت string ارسال می شود
- Name
mobile *- Type
- string
- Description
شماره موبایل مورد نظر برای خرید شارژ که حتما باید با این فرمت باشد :
98902XXXXXXX
- Name
price *- Type
- string
- Description
مبلغ پرداختی اگر محصول انتخاب شده دارای second_price بود شما می توانید مبلغ را از عدد price تا second_price ارسال کنید... و به صورت string ارسال می شود
- Name
webservice_code *- Type
- string
- Description
code مورد نیاز شما برای ذخیره سازی و بررسی و پیگیری درخواست ها
- Name
fake_response- Type
- boolean
- Description
توجه داشته باشید این مقدار فقط در محیط تست با آدرس https://dev.testesaj.ir معتبر می باشد
درخواست
# نمونه درخواست با cURL
curl -X POST "https://gateway.esaj.ir/api/top-up" \
-H "Authorization: Bearer {TOKEN}" \
-H "Idempotency-Key: YOUR_RANDOM_IDENPOTENCY" \
-H "Content-Type: application/json" \
-d '{
"product_id": 62,
"mobile": "98902XXXXXXX",
"price": 5000,
"webservice_code": "YOUR_CODE"
}'
نتیجه درخواست
{
"message": "successful"
}