دریافت اطلاعات اتباع

آدرس سرویس: POST https:/carbon/v4.0/kyc_service/inquiry/fida_inquiry

---

شرح

این سرویس جهت دریافت اطلاعات اتباع مورد استفاده قرار می گیرد.

---

Headers

مقادیر زیر باید در هدر قرار بگیرد

  Authorization : Bearer {Token}
  clientAddress : client IP

توجه : برای دریافت توکن مربوطه به بخش سرویس توکن مراجعه فرمایید

توضیحات

• Authorization: در این قسمت توکن دریافت شده از سرویس توکن را وارد نمایید

• clientAddress: آی پی مشتری نهایی که سرویس را دریافت کرده است .

Parameters

• request_number (نوع داده عددی) :(اجباری) این شناسه جهت پیگیری های بعدی مورد استفاده قرار می گیرد و پیشنهاد میگردد یه شناسه یکتا به ازای هر درخواست توسط سامانه مشتری تولید و به این سرویس ارسال گردد. سامانه ابری کربن هیچ کنترلی بر روی عدم تکراری بودن این مقدار انجام نمی دهد.

• inquiry_type (نوع داده عددی) :(اجباری) نوع ورودی استعلام کد فیدا برابر 2 هست

• code (نوع داده عددی) :(اجباری) کد مربوط به شخص

نمونه درخواست:

curl --location --request POST 'https:/carbon/v4.0/kyc_service/inquiry/fida_inquiry'\
--header 'Authorization: Bearer ....'\
--header 'Content-Type: application/json'\
--data-raw '{
    "request_number": "....",
    "inquiry_type": "....",
    "code": "...."
}'

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2026-04-25 12:58:00.231",
    "tracking_number": "875159266",
    "request_number": "2026212025",
    "result": {
        "fida_code": ....,
        "birth_date": "....",
        "first_name": "....",
        "last_name": "....",
        "father_name": "....",
        "gender": "....",
        "shamsi_birth_date": "....",
        "province_id": ....,
        "province_name": "....",
        "nationality_name": "....",
        "family_id": ....,
        "identity_code": ....,
        "id": ....,
        "is_active": "...."
    },
    "transaction_details": {
        "available_wallet_balance": "....",
        "provider_name": "....",
        "service_price": "0",
        "curency": "IRR",
        "remaining_number_of_calls": "976",
        "remaining_number_of_calls_day": "976"
    },
    "errors": {}
}

جواب ناموفق:

{
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2026-01-12 15:58:42.364",
    "tracking_number": "875153592",
    "request_number": "2025123452026",
    "result": {},
    "transaction_details": {},
    "errors": {
        "error_code": "10124",
        "error_description": "تبعه ای با این مشخصات یافت نشد",
        "reference_name": "P32_E902",
        "original_value": "تبعه ای با این مشخصات یافت نشد"
    }
}

• status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد
• message: پاسخ از طرف سرویس سامانه ابری کربن
• timestamp: زمان و تاریخ درخواست
• request_number: شماره پیگیری ارسال شده در زمان فراخوانی
• tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
• result: آبجکتی از پاسخ سرویس شامل:
• fida_code: رنگ چک
• birth_date: صاحب چک
• first_name: تاریخ
• last_name : توضیحات درباره چک
• father_name : توضیحات درباره چک
• gender : توضیحات درباره چک
• shamsi_birth_date : توضیحات درباره چک
• province_id : توضیحات درباره چک
• province_name : توضیحات درباره چک
• nationality_name : توضیحات درباره چک
• family_id : توضیحات درباره چک
• identity_code : توضیحات درباره چک
• id : توضیحات درباره چک
• is_active: توضیحات درباره چک
• service_price: قیمت سرویس

در صورت بروز خطا در درخواست :

• errors: جزییات خطا
• error_code: کد مربوط به خطایی که پیش آمده است
• error_description: متن خطا
• reference_name: اطلاعات تکمیلی خطا
• original_value: اطلاعات تکمیلی خطا

---