مستندات API – سرویس تطابقی اطلاعات مالی (شماره کارت و کدملی)
مستندات سرویس API تطابقی اطلاعات مالی (شماره کارت با اطلاعات هویتی)
IBAN (Card) Validate API Documents
نسخه 1.1.0 - 11/28/2023
فهرست مطالب
۱. مقدمه
در سرویس تطابقی اطلاعات مالی (شماره کارت و اطلاعات هویتی) یوآیدی، با ارسال شماره کارت کاربر، می‌توانید تطابق اطلاعات مالی مربوط به صاحب حساب را با اطلاعات هویتی صحت سنجی کنید.
۲. فراخوانی سرویس validate/card/ownership
برای استفاده از سرویس API تطابقی اطلاعات مالی (شماره کارت با اطلاعات هویتی) یوآیدی می‌بایست سرویس زیر با پارامترهای درخواستی فراخوانی نمائید. این سرویس با دریافت شماره کارت کاربر، کدملی و تاریخ تولد صحت اطلاعات کاربر (true یا false) را در پاسخ بر می‌گرداند.
۱.۲. نمونه درخواست
نمونه‌ی درخواست به شرح زیر است:
https://json-api.uid.ir/api/validate/card/ownership
Content-Type: application/json;charset=UTF-8
{
"requestContext" : {
"apiInfo": {
"businessId": <UID_BUSINESS_ID>,
"businessToken": <UID_BUSINESS_TOKEN>
}
},
"cardNumber" : "6037111111111111",// String - 16 Digits
"nationalId" : "0123456789",
"birthDate" : "1370/05/17"
},
۲.۲. توضیح پارامترهای درخواست
| Field | Type | Kind | Description |
| businessId | string | Required | شناسه کسب‌و‌کار (توسط یوآیدی در اختیار قرار می‌گیرد) |
| businessToken | string | Required | توکن کسب‌و‌کار (توسط یوآیدی در اختیار قرار می‌گیرد) |
cardNumber | string | Required | شماره کارت کاربر |
nationalId | string | Required | کد ملی کاربر |
birthDate | string | Required | تاریخ تولد کاربر |
۳.۲. نمونه پاسخ
{
"responseContext": {
"status": {
"code": 0,
"message": "SUCCESS.",
"details": []
},
"requestId": "",
"correlationId": "",
"navigationURI": "",
"nextStepToken": "",
"userSessionId": "",
"custom": {}
},
"isMatched": true
}
۴.۲. توضیح پارامترهای پاسخ
| Field | Type | Description |
| code | int | کد خطا |
| message | string | توضیحات خطا |
| isMatched | bool | تطابق مالکیت: true عدم تطابق مالکیت: false |