دریافت نتیجه احراز هویت

آدرس سرویس: POST https:/carbon/v4.0/kyc_service/authentication/result_authentication

---

شرح

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

---

Headers

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

  Authorization : Bearer {Token}
  clientAddress : client IP

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

توضیحات

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

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

Parameters

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

• reference_number (نوع داده رشته):(اجباری) شماره منبع داده شده

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

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

جواب موفق:

{
    "status": "0",
    "message": "تراکنش با موفقیت انجام شد",
    "timestamp": "2026-04-04 12:38:07.759",
    "tracking_number": "956270973",
    "request_number": "202602042351",
    "result": {
        "authentication_status": "....",
        "message": ".... ",
        "result_authentication": "....",
        "result_description": "...."
    },
    "transaction_details": {
        "available_wallet_balance": "3734336",
        "provider_name": "Pertikan",
        "service_price": "0",
        "curency": "IRR",
        "remaining_number_of_calls": "100",
        "remaining_number_of_calls_day": "100"
    },
    "errors": {}
}

جواب ناموفق:

{
    "status": "1",
    "message": "تراکنش ناموفق",
    "timestamp": "2026-01-12 15:58:42.364",
    "tracking_number": "875153592",
    "request_number": "2025123452026",
    "result": {},
    "transaction_details": {},
    "errors": {
        "error_code": "5002",
        "error_description": "Transaction failed : Provider  Error",
        "reference_name": "47_",
        "original_value": ""
    }
}

جدول خطا

Value	Result	Description
FINAL_AUTHENTICATION_RESULT_REASON_UNDEFINED	UNDEFINED	در حال انتظار
FINAL_AUTHENTICATION_RESULT_REASON_ACCEPT	ACCEPTED	تایید شده
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_FACE_NOT_MATCH_IMAGE_ID	REJECTED	عدم تطبیق چهره با ثبت احوال
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_VIDEO_NOT_LIVE	REJECTED	زنده نبودن ویدئو ارسالی
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_VIDEO_BAD_LIGHT	REJECTED	نور نامناسب
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_INCOMPATIBLE_HEJAB	REJECTED	حجاب نامناسب
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_INCOMPATIBLE_ANGLE_CAMERA	REJECTED	زاویه نامناسب دوربین
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_INCOMPATIBLE_BACKGROUND	REJECTED	پس زمینه نامناسب
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_INCOMPATIBLE_LOOK_CAMERA	REJECTED	عدم نگاه کردن به دوربین
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_VIDEO_BAD_QUALITY	REJECTED	عدم وضوح تصویر
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_PERSON_TOO_FAR_AWAY	REJECTED	فاصله بیش از حد با دوربین
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_MORE_THAN_ONE_PERSON	REJECTED	وجود چند چهره
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_NO_PERSON_DETECTED	REJECTED	عدم وجود چهره
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_FAKE_VIDEO	REJECTED	ویدیو فیک / کیفیت پایین ویدیو
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_INVALID_SIGNATURE	REJECTED	مغایرت امضا
FINAL_AUTHENTICATION_RESULT_REASON_REJECT_USER_DID_NOT_SPEAK_REQUIRED_TEXT	REJECTED	مغایرت متن ارسالی و متن بازگوشده کاربر

• status: عدد 0 به معنی موفق و عدد 1 به معنی ناموفق می باشد
• message: پاسخ از طرف سرویس سامانه ابری کربن
• timestamp: زمان و تاریخ درخواست
• request_number: شماره پیگیری ارسال شده در زمان فراخوانی
• tracking_number: شماره پیگیری ایجاد شده توسط سامانه ابری کربن جهت بررسی های بعدی
• result: آبجکتی از پاسخ سرویس شامل:
• authentication_status: وضعیت احراز هویت
• message: پیام
• result_authentication: نتیجه احراز هویت
• result_description: توضیحات نتیجه درخواست
• service_price: قیمت سرویس

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

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

---