تطبیق اطلاعات بانکی و هویتی
خدمتدهنده
معماران فناوری هوشمند
مقدمه
پیش از شروع
- URL فراخوانی سرویسها:
Production Server: https://api.pod.ir/srv/sc/nzh/doServiceCall
Sandbox Server:https://sandbox.pod.ir/srv/sc/nzh/doServiceCall
- تمامی درخواستها با متد POST ارسال میشوند.
- فیلدهای زیر درHeader تمامی درخواستها ثابت است:
پارامتر | توضیحات |
_token_ | توکن کسبوکاری دریافتی از پنل |
_token_issuer_ | مقدار ثابت "1" |
- فیلدهای زیر در بدنهی تمامی درخواستها ثابت است (با فرمت x-www-form-urlencoded):
پارامتر | توضیحات |
scProductId | شناسهی سرویس مدنظر |
scApiKey | راهنمای دریافت این پارامتر در این لینک موجود است. |
- علاوه بر موارد بالا که ثابت هستند، اگر سرویس نیاز به پارامتر دیگری داشته باشد در داکیومنت مربوطه ذکر شده است.
- خروجی: ساختار کلی پاسخ دریافتی در این لینک به تفصیل شرح داده شده است.
نکته: پس از درخواست سرویس به پادیوم، همکاران ما درخواستهای ارسالی را بررسی میکنند. در صورت عدم دریافت تایید کرد بر روی درخواست ارسالی ظرف یک روز کاری،به همکاران ما از طریق شماره تلفن (021-89518989) و یا در گروه واتساپ اطلاع دهید تا دسترسی به سرویس موردنظر برای شما فعال شود.
این سرویس با دریافت شناسه ملی شخص و تاریخ تولد و شماره کارت بانکی او می تواند تطبیق آنها را به کاربر اعلام کند.
نکات:
- با این وب سرویس می توان تعلق داشتن یک شماره کارت به صاحب آن با کد ملی مشخص را بررسی کرد.
- این وب سرویس جزء دسته استعلاماتی می باشد.
تطبیق اطلاعات هویتی و کارت بانکی
شناسه سرویس: 3886830
شناسه سرویس سند باکس: 166562
پارامترهای ورودی
Body | ||
توضیحات | نوع | نام پارامتر |
تاریخ تولد | String | BirthDate |
شناسه ملی | String | NationalID |
شماره کارت بانکی | String | CardNumber |
پارامترهای خروجی
Respone | ||
توضیحات | نوع | نام پارامتر |
جزئیات نتیجه از پروایدر | StringifyJSON | result.result |
وضعیت نتیجه در پروایدر | Int | result.statusCode |
کد خطای پادیوم. مقدار 0 به معنای بدون خطا است | Int | result.result.ErrorCode |
پارامتر خطا دار پادیوم | String | result.result.ErrorParameter |
متن خطای پادیوم | String | result.result.Message |
در صورت اخذ هزینه از کاربر true خواهد بود | Boolean | result.result.PaidCall |
وضعیت عملیات در پروایدر | String | result.result.StatusSat |
شناسه ملی شخص و تاریخ تولد و شماره کارت بانکی تطبیق دارند | Boolean | result.result.Matched |
کد وضعیت عملیات در پروایدر. مقدار 0 به معنای نتیجه موفق است | Int | result.result.StatusCodeSat |
متن خطای پروایدر | String | result.result.MessageSat |
پارامتر خطا دار پروایدر | َObjectArray | result.result.Details |
شناسه | String | result.result.TrackID |
زمان | Long | result.result.TimeStamp |
نمونه مقادیر پارامترهای ورودی سرویس سندباکس
Body | |
مقدار | نام پارامتر |
166562 | scProductId |
13590117 - 13590116 - 1359011 - 1359011x | BirthDate |
0069496943 - 0069496942 - 006949694 - 006949694x | NationalID |
5022291007217753 - 5022291007217752 - 502229100721775 - 502229100721775x | CardNumber |
نمونه درخواست با مقادیر درست
Request |
HTTP
|
نمونه پاسخ موفقیت آمیز
Response |
JSON
|
نمونه درخواست با مقادیر نادرست
Request |
HTTP
|
نمونه پاسخ خطا
Response |
JSON
|
نمونه درخواست با مقادیر درست
Request |
HTTP
|
نمونه پاسخ خطا ناشی از مشکل در سرور
Response |
JSON
|
استعلام تطبیق شماره شبا و هویت
این سرویس با دریافت شناسه ملی شخص و تاریخ تولد و شماره شبای او می تواند تطبیق آنها را به کاربر اعلام کند.
نکات:
- با این وب سرویس می توان تعلق داشتن یک شماره شبا به صاحب آن با کد ملی مشخص را بررسی کرد.
- این وب سرویس جزء دسته استعلاماتی می باشد.
شناسه سرویس: 3886841
شناسه سرویس سند باکس: 166568
پارامترهای ورودی
Body | ||
توضیحات | نوع | نام پارامتر |
تاریخ تولد | String | BirthDate |
شناسه ملی | String | NationalID |
شماره شبا | String | Iban |
پارامترهای خروجی
Respone | ||
توضیحات | نوع | نام پارامتر |
جزئیات نتیجه از پروایدر | StringifyJSON | result.result |
وضعیت نتیجه در پروایدر | Int | result.statusCode |
کد خطای پادیوم. مقدار 0 به معنای بدون خطا است | Int | result.result.ErrorCode |
پارامتر خطا دار پادیوم | String | result.result.ErrorParameter |
متن خطای پادیوم | String | result.result.Message |
در صورت اخذ هزینه از کاربر true خواهد بود | Boolean | result.result.PaidCall |
وضعیت عملیات در پروایدر | String | result.result.StatusSat |
زمان | Long | result.result.TransactionTime |
شناسه | String | result.result.Uuid |
شناسه ملی شخص و تاریخ تولد و شماره شبا تطبیق دارند | String | result.result.IbanCheckResult |
کد وضعیت عملیات در پروایدر. مقدار 0 به معنای نتیجه موفق است | Int | result.result.StatusCodeSat |
متن خطای پروایدر | String | result.result.MessageSat |
پارامتر خطا دار پروایدر | َObjectArray | result.result.Details |
شناسه | String | result.result.TrackID |
زمان | Long | result.result.TimeStamp |
نمونه مقادیر پارامترهای ورودی سرویس سندباکس
Body | |
مقدار | نام پارامتر |
166568 | scProductId |
13590117 - 13590116 - 1359011 - 1359011x | BirthDate |
0069496943 - 0069496942 - 006949694 - 006949694x | NationalID |
IR880570022280000256223001 - IR880570022280000256223009 IR88057002228000025622300 - IR88057002228000025622300x | Iban |
نمونه درخواست با مقادیر درست
Request |
HTTP
|
نمونه پاسخ موفقیت آمیز
Response |
JSON
|
نمونه درخواست با مقادیر نادرست
Request |
HTTP
|
نمونه پاسخ خطا
Response |
HTTP
|
نمونه درخواست با مقادیر درست
Request |
HTTP
|
نمونه پاسخ خطا ناشی از مشکل در سرور
Response |
JSON |
کد خطاهای رسپانس
Response | |
کد خطا | توضیح |
صفحه HTML با خطای 404 | منبع درخواستی در سرور پیدا نشد |
صفحه HTML با خطای 408 | پایان مهلت زمانی سرور به کانکشن کلاینت |
صفحه HTML با خطای 502 | خطا در دریافت در درگاه سرور از سرور پروایدر |
صفحه HTML با خطای 503 | سرور آماده سرویس دهی نیست |
صفحه HTML با خطای 504 | پایان مهلت زمانی درگاه دریافت کننده سرور به سرور پروایدر |
کد خطاهای پادیوم
errorCode | |
کد خطا | توضیح |
0 | بدون خطا |
12 | خطا در فراخوانی سرویس سعی تطبیق تاریخ تولد و شناسه ملی و شماره شبا |
21 | توکن کسب وکاری وارد نشده است |
227 | تایم اوت سرویس اصلی |
378 | ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است |
462 | محدودیت در نسخه سند باکس |
999 | خطای داخلی سیستم |
result.result.ErrorCode | |
کد خطا | توضیح |
0 | بدون خطا |
11 | عملیات با موفقیت انجام نشد |
12 | خطا در فراخوانی سرویس سعی تطبیق تاریخ تولد و شناسه ملی و شماره شبا |
کد خطاهای پروایدر
result.result. StatusCodeSat | |
کد خطا | توضیح |
0 | بدون خطا |
422 | خطا در مقدار پارامترهای ارسالی |