خدمات خرید شارژ تلفن همراه

مقدمه

با استفاده از سرویس شارژ دو مرحله ای میتوانید اینترنت و شارژ خریداری کنید.

روال استفاده از این سرویس به شرح زیر است:

برای خرید شارژ سرویس 1426068 فراخوانی میشود . این سرویس ورودی json  ، data دارد.

برای خرید شارژ و اینترنت  دو گزینه وجود دارد . استفاده از شاپ یا ایساج که داکیومنت آن ها در سایت پادیوم موجود است . از هر سرویسی برای خرید استفاده میکنید باید پارامترهای اجباری آن سرویس را در data بگذارید . علاوه بر پارامترهای ضروری باید یک آدرس بازگشت (url)ومقدار شارژ (amount) را وارد کنید . هم چنین در data  باید serviceId سرویسی که انتخاب کرده اید (شاپ یا ایساج) را وارد نمایید.

سرویس 1426068 در صورت موفقیت یک لینک پرداخت و یک شماره فاکتور برمیگردانید . با لینک پرداخت میتوانید به درگاه بروید و خرید انجام دهید . شماره فاکتور هم برای استعلام وضعیت خرید شماست.

برای استعلام از سرویس 1426118   استفاده میکنید و وردی به آن شماره فاکتور را میدهید. این سرویس وضعیت خرید شما را مشخص میکند.

توجه کنید اگر سرویس ایساج را انتخاب کردید order_id یک شناسه یونیک ارسال کنید و تکراری نباشد

پیش از شروع

• URL فراخوانی سرویس­ها:

Production Server: https://api.pod.ir/srv/sc/nzh/doServiceCall

Sandbox Server:https://sandbox.pod.ir/srv/sc/nzh/doServiceCall

• تمامی درخواست­ها با متد POST ارسال می­شوند.
• فیلدهای زیر درHeader تمامی درخواست­ها ثابت است:

• فیلدهای زیر در بدنه‌ی تمامی درخواست‌ها ثابت است (با فرمت x-www-form-urlencoded):

• علاوه بر موارد بالا که ثابت هستند، اگر سرویس نیاز به پارامتر دیگری داشته باشد در داکیومنت مربوطه ذکر شده است.
• خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.

نکته:پس از درخواست سرویس به پادیوم، همکاران ما درخواستهای ارسالی را بررسی می‌کنند. در صورت عدم دریافت تایید کرد بر روی درخواست ارسالی ظرف یک روز کاری،به همکاران ما از طریق شماره تلفن (021-89518989) و یا در گروه واتس‌اپ اطلاع دهید تا دسترسی به سرویس موردنظر برای شما فعال شود.

خرید شارژ

• شناسه‌ی سرویس: 1426068

• پارامترهای ورودی

اگر میخواهید از سرویس ایساج برای خرید شارژ استفاده کنید پارامترهایی که در آبجکت data میفرستید به صورت زیر است.

اگر میخواهید از سرویس شاپ برای خرید شارژ استفاده کنید پارامترهایی که در آبجکت data میفرستید به صورت زیر است.

بدنه­ی پاسخ دریافتی دارای ساختار زیر است:

نمومه پاسخ صحیح در صورت فراخونی سرویس خرید شارژ

"{\"hasError\":false,\"message\":\"عملیات با موفقیت انجام شد !\",\"result\":[{\"statusCode\":200,\"data\":{\"payment_link\":\"xxxx \",\”billNumber\”:\”yyyy\”}}]}",

با استفاده از فیلد payment_link به درگاه رفته و پرداخت را انجام دهید.

مقدار billNumber  را برای استعلام وضعیت پرداخت نگه دارید.

در صورت موفق بودن پرداخت و خرید شارژ ریسپانس به ادرس بازگشتی که در ابتدا گذاشته بودید فرستاده میشود.

در کواری استرینگ یک پارامتر به اسم dataبازگردانده میشود که ساختار آن به صورت زیر است:
 

کدهای ارور (errorCode) معمول در پلتفرم:

برای مشاهده‌ی کدهای ارور پلتفرم به این لینک مراجعه کنید.

کدهای خطای سرویس اصلی:

4.1 در صورتی که ادرس بازگشت وارد نشود :

{\"hasError\":true,\"message\":\"آدرس بازگشت خود را وارد کنید\",\"result\":[{\"statusCode\":401,\"data\":{}}]}",

کد 401 برگردانده میشود

4.2 در صورتی که پارامترهای اجباری خرید شارژ ارسال نشود

"{\"hasError\":true,\"message\":\"را وارد کنید130429 پارامترهای این\",\"result\":[{\"statusCode\":401,\"data\":{}}]}",

کد 401 برگردانده میشود

4.3 در صورتی که توکن بیزینس در هدر فرستاده نشود

"{\"hasError\":true,\"message\":\"توکن کسب و کار خود را وارد کنید \",\"result\":[{\"statusCode\":401,\"data\":{}}]}",

کد 401 برگردانده میشود

4.4 در صورتی که پرداخت درگاه شما ناموفق بوده باشد

"{\"hasError\":true,\"message\":\"پرداخت شما ناموفق بوده است\",\"result\":[{\"statusCode\":500,\"data\":{}}]}",

کد 500 برگردانده میشود

4.5 اگر مشکلی در ثبت سفارش پیش آید این ریسپانس به شما داده میشود

"{\"hasError\":true,\"message\":\سفارشی با این شناسه فاکتور ثبت نشده است \",\"result\":[{\"statusCode\":500,\"data\":{}}]}",

کد 500 برگردانده میشود

استعلام شارژ

• شناسه‌­ی سرویس: 1426118

• پارامترهای ورودی

خروجی: 

• بدنه­‌ی پاسخ دریافتی دارای ساختار زیر است:

نمومه پاسخ صحیح در صورت فراخونی سرویس استعلام شارژ

با استفاده از status  موجود در ریسپانس میتوانید وضعیت خرید را مشاهده نمایید.

کدهای خطای سرویس اصلی:

4.1 در صورتی که شماره فاکتور وارد شده ثبت نشده باشد:

 "{\"hasError\":true,\"message\":\"پرداختی با این شناسه فاکتور وجود ندارد\",\"result\":[{\"statusCode\":403,\"data\":{}}]}"

کد 403 برگردانده میشود