POST/api/v1/zoloz/realid/checkresult

ZOLOZ Real ID checkresult API は、本人確認プロセスの実行ステータスと、基本および詳細なドキュメント検証結果、顔検証結果、リスク管理結果などを含むその他の対応する結果に関する結果をリクエストするために使用されます。この API はべき等です。

構造

リクエストパラメーター

フィールド名	データ型	最大長	デフォルト値	説明
bizId	String	32	-	必須。追跡用の固有のビジネス ID。たとえば、加盟店のビジネス関連データベースからのシーケンス ID。注: ZOLOZ サーバーはこのフィールドの値の一意性チェックを実行しません。追跡を改善するために、加盟店サーバーでビジネス ID の一意性を保証することを強くお勧めします。
transactionId	String	64	-	必須。のレスポンスで返される一意のトランザクション ID です。API を初期化する。
isReturnImage	String	1	N	オプション。レスポンスで画像データを返す必要があるかどうかを指定するフラグ。以下の値がサポートされています。 `Y`: レスポンスで画像データを返す必要があります。 `N`: レスポンスで画像データを返す必要はありません。
extraImageControlList	List<String>		[]	オプション。 isReturnImage が "Y" の場合、追加のドキュメント画像を返すかどうかを指定します。以下の値がサポートされています。 `FACE_EYE_CLOSE`: 目を閉じた顔画像を返します `DOC_FRONT_ANGLE`: 複数の角度でキャプチャされたドキュメントの最初のページの画像を返します。 `DOC_FRONT_FLASH`: フラッシュライトをオンにしてキャプチャされたドキュメントの最初のページの画像を返します。 `DOC_BACK_ANGLE`: 複数の角度でキャプチャされたドキュメントの裏面の画像を返します。 `DOC_BACK_FLASH`: フラッシュライトをオンにしてキャプチャされたドキュメントの裏面の画像を返します。 `CROPPED_FACE`: キャプチャされた元の顔画像からトリミングされた追加の顔画像を返します。注: 追加画像が返される可能性は、これらの画像が正常にキャプチャされたかどうかに依存します。これは、initialize API で設定された統合モードと serviceLevel 値の両方によって決定されます。たとえば、選択された統合モードがネイティブアプリ SDK で、serviceLevel 値が `REALID0002` の場合、`DOC_FRONT_FLASH` がキャプチャされ、返される可能性があります。
returnFiveCategorySpoofResult	String	1	N	オプション。ドキュメントのなりすましチェック結果を 5 つのカテゴリで返すかどうかを指定します。有効な値は次のとおりです。 `Y`: ドキュメントのなりすましチェック結果が次の 5 つのカテゴリで返されます。 `TAMPER_CHECK` `MATERIAL_CHECK` `SCREEN_RECAPTURE_CHECK` `INFORMATION_CHECK` `SECURITY_FEATURE_CHECK` `N`: ドキュメントのなりすましチェック結果が次の 4 つのカテゴリで返されます。 `TAMPER_CHECK` `MATERIAL_CHECK` `SCREEN_RECAPTURE_CHECK` `OTHER_CHECK`

レスポンスパラメーター

フィールド名	データ型	説明
result	Result	必須。 API リクエスト結果。ステータスやエラーコードなど、API リクエストの結果に関する情報が含まれています。
ekycResult	String	オプション。本人確認プロセス全体の実行ステータスを指定します。このフィールドは、result.resultSatus フィールドの値が `S` の場合にのみ使用できます。可能な値とその意味は次のとおりです。 `Success`: 本人確認プロセスは正常に実行されました。 `Pending`: 本人確認プロセスは保留中です。 `Failure`: 本人確認プロセスは失敗しました。これは、ドキュメント検証、顔検証、またはリスク管理処理の少なくとも 1 つが失敗したことを示します。 `InProcess`: 本人確認プロセスは進行中です。 `VoidCancelled`: 本人確認プロセスはキャンセルされました。 `VoidTimeout`: 本人確認プロセスはタイムアウトしました。
extBasicInfo	ExtBasicInfo	オプション。基本的な実名情報。このフィールドは、result.resultStatus フィールドの値が `S` に設定されている場合にのみ使用できます。詳細については、Real ID - checkresult を参照してください。
extFaceInfo	ExtFaceInfo	eKYC アプリケーションの顔情報の詳細です。 result.resultStatus が `S` の場合にのみ利用可能です。詳細については、以下の表を参照してください。オプション。顔検証に関する詳細情報。このフィールドは、result.resultStatus フィールドの値が `S` に設定されている場合にのみ使用できます。詳細については、Real ID - checkresult を参照してください。
extIdInfo	ExtIdInfo	オプション。ドキュメント検証に関する詳細情報。このフィールドは、result.resultStatus フィールドの値が `S` に設定されている場合にのみ使用できます。詳細については、Real ID - checkresult を参照してください。
extRiskInfo	ExtRiskInfo	オプション。リスク管理に関する詳細情報。このフィールドは、result.resultStatus フィールドの値が `S` に設定されている場合にのみ使用できます。詳細については、Real ID - checkresult を参照してください。
extCustomInfo	ExtCustomInfo	オプション。カスタマイズ情報に関する詳細情報。このフィールドは、result.resultStatus フィールドの値が `S` に設定されている場合にのみ使用できます。詳細については、Real ID - checkresult を参照してください。

結果

結果処理ロジック

リクエスト結果ごとに、実行されるアクションが異なります。詳細については、以下を参照してください。

result.resultStatusです S の場合、ZOLOZ Real ID checkresult API が正常に呼び出され、ドキュメント検証、顔検証、およびリスク管理処理に関する結果が返されます。
result.resultStatusです F の場合、ZOLOZ Real ID checkresult API が失敗しました。考えられる原因の詳細については、エラーコードとメッセージを確認してください。エラーコード。

一般的なエラーコード

一般的なエラーコードの完全なリストについては、「エラー処理」セクションの「エラー処理」トピックを参照してください。

API 固有のエラーコード

次の表は、Real ID checkresult API に固有の考えられるエラーコードを示しています。

resultCode	resultSatus	説明
SUCCESS	S	API 呼び出しは成功しました。
INVALID_ARGUMENT	F	入力パラメーターが無効です。どのパラメーターが無効かの詳細については、結果メッセージまたは関連ログを確認してください。
SYSTEM_ERROR	F	その他の内部エラー。エラーの詳細については、結果メッセージまたは関連ログを確認してください。

サンプル

リクエストサンプル

次のサンプルは、加盟店サーバーが送信するリクエストの例を示しています。

{
    "bizId": "2017839040588699",
    "transactionId": "G000000005FID20200304000000000001570702",
    "isReturnImage": "Y",
    "extraImageControlList": [
      "FACE_EYE_CLOSE",
      "DOC_FRONT_ANGLE"
    ],
    "returnFiveCategorySpoofResult": "Y"
}

レスポンスサンプル

次のサンプルは、ZOLOZ サーバーが返すレスポンスの例を示しています。

{
  "result": {
    "resultCode": "SUCCESS",
    "resultMessage": "Success",
    "resultStatus": "S"
  },
  "ekycResult": "Pending",
  "extBasicInfo": {
    "certType": "08530000001",
    "certNo": "A12345678",
    "certName": "xxxxxx"
  },
  "extFaceInfo": {
    "ekycResultFace": "Success",
    "faceScore": 88,
    "faceImg": "/9j/4AA..[omitted]..PxA=",
    "extraImages": {
      "FACE_EYE_CLOSE": "/9j/4AA..[omitted]..PxA="
    },
    "faceQuality": 97.61517973846627,
    "faceLivenessResult": "Success",
    "estimatedAge": 34,
     "faceAttribute": {
      "occlusionMouthResult": "false",
      "occlusionForeheadResult": "false",
      "occlusionResult": "false",
      "occlusionChinResult": "false",
      "occlusionEyesResult": "false",
      "occlusionNoseResult": "false",
      "occlusionCheekResult": "false",
      "maskResult": "false",
      "glassesResult": "true",
      "hatResult": "false"
   },
    "deeperFaceResult":"Success",
    "deeperFaceResultDescription":"",
    "deviceRisk":{
      "riskLevel": 0
    }
  },
  "extIdInfo": {
    "ekycResultDoc": "Pending",
    "docEdition": 1,
    "frontPageImg": "/9j/4AA..[omitted]..PxA=",
    "backPageImg": "/9j/4AA..[omitted]..PxA=",
    "extraImages": {
      "DOC_FRONT_ANGLE": "/9j/4AA..[omitted]..PxA=",
      "CROPPED_FRONT": "/9j/4AA..[omitted]..PxA=",
      "CROPPED_BACK": "/9j/4AA..[omitted]..PxA="
    },
    "ocrResult": {
      ...
    },
    "ocrResultDetail": {
      "MRZ_ID_NUMBER": {
        "name": "ID_NUMBER",
        "source": "MRZ",
        "value": "xxxx"
      },
      "VISUAL_ID_NUMBER": {
        "name": "ID_NUMBER",
        "source": "VISUAL",
        "value": "xxxx"
      }
    },
    "spoofResult": {
        "TAMPER_CHECK": "Y",
        "MATERIAL_CHECK": "Y",
        "SCREEN_RECAPTURE_CHECK": "Y",
        "INFORMATION_CHECK": "Y",
        "SECURITY_FEATURE_CHECK": "Y"
    },
    "extraSpoofResultDetails": [
      {
        "name": "landmarkCheck",
        "result": "Y",
        "spoofType": "SECURITY_FEATURE_CHECK",
        "components": [
          {
            "name": "kadPengenalan",
            "subResult": "Y"
          },
          {
            "name": "mykadLogo",
            "subResult": "Y"
          },
          {
            "name": "flagLogo",
            "subResult": "Y"
          },
          {
            "name": "mscLogo",
            "subResult": "Y"
          },
          {
            "name": "ghostFace",
            "subResult": "Y"
          },
          {
            "name": "hibiscusLogo",
            "subResult": "Y"
          },
          {
            "name": "coatOfArm",
            "subResult": "Y"
          },
          {
            "name": "twinTower",
            "subResult": "Y"
          }
        ]
      },
      {
        "name": "hologramCheck",
        "result": "Y",
        "spoofType": "SECURITY_FEATURE_CHECK",
        "components": [
          {
            "name": "hologram",
            "subResult": "Y"
          }
        ]
      },
      {
        "name": "pageInfoCheck",
        "result": "Y",
        "spoofType": "INFORMATION_CHECK",
        "components": [
          {
            "name": "id",
            "subResult": "Y"
          },
          {
            "name": "symbol",
            "subResult": "Y"
          },
          {
            "name": "name",
            "subResult": "Y"
          }
        ]
      }
    {
        "result": "N",
        "components": [
          {
            "subResult": "N",
            "name": "ID_NUMBER"
          }
        ],
        "spoofType": "INFORMATION_CHECK",
        "name": "commonConsistencyCheck"
      },
      {
        "result": "N",
        "components": [
          {
            "subResult": "N",
            "name": "NAME"
          },
          {
            "subResult": "Y",
            "name": "SEX"
          }
        ],
        "spoofType": "INFORMATION_CHECK",
        "name": "mrzVisualConsistencyCheck"
      }
    ], 
    "securityFeaturesResult": {
      "LASER_IMAGE_1_SCORE":95,
      "LASER_IMAGE_1_THRESHOLD":90,
      "LASER_IMAGE_1_PASSED":"True",
      "HOLOGRAM_SCORE":95,
      "HOLOGRAM_THRESHOLD":90,
      "HOLOGRAM_PASSED":"True",
      "STEREO_LASER_PORTRAIT_SCORE":95,
      "STEREO_LASER_PORTRAIT_THRESHOLD":90,
      "STEREO_LASER_PORTRAIT_PASSED":"True",
      "LASER_IMAGE_2_SCORE":95,
      "LASER_IMAGE_2_THRESHOLD":90,
      "LASER_IMAGE_2_PASSED":"True",
      "OVERALL_SCORE":95,
      "OVERALL_THRESHOLD":90,
      "OVERALL_PASSED":"True"
    },
    "docErrorDetails": "BLUR",
    "docErrorDescription": "xxx"
  },
   "extRiskInfo": {
    "ekycResultRisk": "Pending",
    "strategyPassResult": "ID_NETWORK_HIGH_RISK",
    "idNetworkDetails": "[{\"ekyc_id\":\"\",\"mobile\":\"\",\"reason_code\":[\"SIMILAR_FACE\"],\"type\":\"Fake ID\",\"user_id\":\"idn-z8Cuj\"}]",
    "deeperRiskResult":"Success",
    "deeperRiskResultDescription":"",
    "advancedIdnDetail": {
        "itemId": "AIN20240823437824356351",
        "riskDetails": [
                {
                  "riskData": [
                      "AIN20240823437671943639"
                    ],
                  "subType": "SamePersonDifferentFace",
                  "type": "IDFAKE"
                },
                {
                  "riskData": [
                      "AIN20240823437672383752",
                      "AIN20240822429059966837"
                    ],
                  "subType": "SamePersonDifferentIdNumber",
                  "type": "IDFAKE"
                }
            ]
        },
    "blackListDetails":[
      {
          "listId": "10064",
          "itemId": "95c0e4e55d5cd5485edaa573d15e82**",
          "itemType": "FACE",
          "similarScore": 99.99999999999999,
          "transactionId": "G000000001FRL202410100000000109481109**"
      },
      {
          "listId": "10066",
          "itemId": "20015",
          "itemType": "CERT",
          "similarScore": 100
      }
    ]
  },
  "extCustomInfo": {"h5Degraded":"Y"}
}

「securityFeaturesResult」フィールドは非推奨です。詳細については、香港ドキュメント SecurityFeature アップグレード通知 - 2024 年 5 月 31 日を参照してください。 API の互換性のために、このフィールドはレスポンスに残ります。実際のレスポンスがどのように見えるかを示すために、例に含めています。いかなる状況においても使用しないでください。

詳細情報

ExtBasicInfo

次の表は、ExtBasicInfo データモデルで指定できるフィールドを示しています。

フィールド名	データ型	説明
certType	String	ID タイプ。本人確認書類の種類を指定します。ドキュメント検証プロセスが正常に実行された場合は必須です。
certNo	String	ID 番号。本人確認書類から認識された ID 番号を指定します。ドキュメント検証プロセスが正常に実行された場合は必須です。
certName	String	ID 名。本人確認書類から認識された名前を指定します。ドキュメント検証プロセスが正常に実行された場合は必須です。

ExtFaceInfo

次の表は、ExtFaceInfo データモデルで指定できるフィールドを示しています。

フィールド名	データ型	説明
ekycResultFace	String	顔検証プロセスの結果を指定します。可能な値とその意味は次のとおりです。 `Success`: 顔検証プロセスは正常に実行されました。 `Pending`: 顔検証プロセスは保留中です。 `Failure`: 顔検証プロセスは失敗しました。顔検証プロセスが正常に実行された場合は必須です。
faceScore	Integer	ライブフェイス (セルフィー) と本人確認書類から認識されたフェイスを比較した結果を示すスコアを指定します。このフィールドの値は 0 ～ 100 の範囲です。注: faceScore フィールドは、顔画像が正常に収集された場合にのみ返されます。
faceImg	String	Base64 でエンコードされた顔の自撮り画像です。このフィールドは、リクエストの isReturnImage フィールドの値が `Y` に設定され、顔認証プロセスが正常に実行された場合にのみ指定されます。
extraImages	Map<String,String>	request.extraImageControlList で指定された追加の顔画像が含まれています。キーは、request.extraImageControlList で指定された値です。値は、base64 でエンコードされた画像コンテンツです。リクエストされた画像が見つからない場合、値は "" になります。
faceQuality	Double	顔のセルフィー画像の品質スコアを指定します。顔検証プロセスが正常に実行された場合は必須です。このフィールドの値は 0 ～ 100 の範囲です。
faceLivenessResult	String	顔の生存確認アルゴリズムを使用して、顔の自撮り画像が偽の顔攻撃として検出されるかどうかを指定します。画像が偽の顔攻撃でない場合、 `Success` の値が返されます。それ以外の場合、`Failure` の値が返されます。
estimatedAge	Integer	顔のセルフィー画像に基づいて推定年齢を指定します。注: 年齢推定の精度は、0 ～ 10 歳の年齢誤差範囲内で 95% です。このフィールドの値は参照用であり、ZOLOZ によるビジネス判断には使用されません。特定の年齢のトランザクションをインターセプトする必要がある場合は、独自の検証ロジックを追加してください。
faceAttribute	FaceAttribute	顔属性検出の結果を指定します。詳細については、faceAttribute を参照してください。注: このフィールドは、faceAttributeCheck パラメーターが渡され、Real ID の `detectOpen` に設定されています`Y` 内の initialize API で
deeperFaceResult	String	オプション。詳細な顔検出結果を指定します。`deeperMode` が CLOSED 以外に設定されている場合に返されます。以下の値が返されます。 `Success`: AIGC 攻撃リスクは検出されていません。 `Failure`: AIGC 攻撃リスクが検出されました。
deeperFaceResultDescription	String	オプション。`deeperMode` が CLOSED 以外に設定され、`deeperFaceResult` が `Failure` を返す場合に、詳細な顔検出結果の詳細な説明を指定します。
deviceRisk	DeviceRisk	オプション。返されたデバイスリスク情報。このフィールドは、プロダクトを購入し、より深くプロダクトと `deeperMode`パラメーターが「CLOSED」に設定されていませんinitialize API で DeviceRisk 詳細については、

faceAttribute

フィールド名	データ型	説明
occlusionMouthResult	String	口の閉塞検出結果を指定します。 `true`: 閉塞が存在します。 `false`: 閉塞はありません。
occlusionForeheadResult	String	額の閉塞検出結果を指定します。 `true`: 閉塞が存在します。 `false`: 閉塞はありません。
occlusionResult	String	全体的な閉塞検出結果を指定します。 `true`: 閉塞が存在します。 `false`: 閉塞はありません。
occlusionChinResult	String	顎の閉塞検出結果を指定します。 `true`: 閉塞が存在します。 `false`: 閉塞はありません。
occlusionEyesResult	String	目の閉塞検出結果を指定します。 `true`: 閉塞が存在します。 `false`: 閉塞はありません。
occlusionNoseResult	String	鼻の閉塞検出結果を指定します。 `true`: 閉塞が存在します。 `false`: 閉塞はありません。
occlusionCheekResult	String	頬の閉塞検出結果を指定します。 `true`: 閉塞が存在します。 `false`: 閉塞はありません。
maskResult	String	マスク検出結果を指定します。 `true`: マスクが存在します。 `false`: マスクは検出されませんでした。
glassesResult	String	眼鏡検出結果を指定します。 `true`: 眼鏡が存在します。 `false`: 眼鏡はありません。
hatResult	String	帽子の検出結果を指定します。 `true`: 帽子が存在します。 `false`: 帽子はありません。

DeviceRisk

フィールド名

データ型

説明

riskLevel

Integer

オプション。リスクレベルと対応する推奨事項:

-1: 顔のインジェクションリスクを特定できません。さらなる評価をお勧めします。
注記：シンガポールサイトではこの機能はサポートされておらず、riskLevel は-1を返します。
0: リスクなし。顔のインジェクションリスクは検出されませんでした。自由に続行してください。
1: 低リスク。リスクマークと監視をお勧めします。
2: 中リスク。 SMS 検証などのさらなるセキュリティチェックをお勧めします。
3: 高リスク。直接インターセプトをお勧めします。

ExtIdInfo

次の表は、ExtIdInfo データモデルで指定できるフィールドを示しています。

フィールド名	データ型	説明
ekycResultDoc	String	ドキュメント検証プロセスの結果を指定します。可能な値とその意味は次のとおりです。 `Success`: ドキュメント検証プロセスは正常に実行されました。 `Pending`: ドキュメント検証プロセスは保留中です。 `Failure`: ドキュメント検証プロセスは失敗しました。ドキュメント検証プロセスが正常に実行された場合は必須です。
docEdition	Integer	本人確認書類のエディションを指定します。 `1`～`3`: 本人確認書類のエディション。詳細については、サポートされているドキュメントの種類と返される OCR 結果を参照してください。 `0`: 本人確認書類を分類できないか、ドキュメントタイプが間違っています `-1`: 不明なエラー
frontPageImg	String	本人確認書類の表面画像。画像は base64 でエンコードする必要があります。このフィールドは、リクエストの isReturnImage フィールドの値が `Y` に設定され、ドキュメント検証プロセスが正常に実行された場合にのみ指定されます。
backPageImg	String	本人確認書類の裏面画像 (存在する場合)。画像は base64 でエンコードする必要があります。このフィールドは、リクエストの isReturnImage フィールドの値が `Y` に設定され、ドキュメント検証プロセスが正常に実行され、本人確認書類の裏面画像のアップロードが必要な場合にのみ指定されます。ドキュメント検証プロセスが正常に実行され、身分証明書の表面画像をアップロードする必要があります。
extraImages	Map<String,String>	request.extraImageControlList および request.cropImage パラメーターで指定された追加のドキュメント画像が含まれています。キーは、request.extraImageControlList が空白でない場合、request.extraImageControlList で指定された値です。 request.cropImage が空白でない場合の有効なキー値: `CROPPED_FRONT`: ドキュメントの最初のページをトリミングして返します `CROPPED_BACK`: ドキュメントの 2 ページ目をトリミングして返します値は、base64 でエンコードされた画像コンテンツです。リクエストされた画像が見つからない場合、値は "" になります。
ocrResult	Map	OCR の結果で、ID に関する情報が含まれます。ドキュメント検証プロセスが正常に実行された場合に必須です。ID ドキュメントの種類に応じて、認識される ID 情報のセットが異なります。詳細については、サポートされているドキュメントの種類と返される OCR の結果をご参照ください。
ocrResultDetail	Map<String, OcrResultDetail>	OCR 結果の詳細。このフィールドは、`mrzVisualConsistencyCheck` は initialize API で
spoofResult	Map	オプション。なりすましチェック結果。改ざん、ドキュメント資料の信憑性、画面キャプチャの観点からのチェック結果に関する情報が含まれます。詳細については、spoofResult をご参照ください。
extraSpoofResultDetails	List<ExtraSpoofResultDetail>	オプション。追加のドキュメントなりすまし検出結果の詳細。詳細については、extraSpoofResultDetails を参照してください。
securityFeaturesResult	Map	このフィールドは非推奨です。詳細については、香港ドキュメント SecurityFeature アップグレードのお知らせ - 2024年5月31日を参照してください。
docErrorDetails	String	オプション。ドキュメント検証プロセスのエラーの詳細を指定します。可能な値とその意味は次のとおりです。 `NO_REQUIRED_ID`: アップロードされた画像から認識された ID が、指定された本人確認書類の種類と一致しません。 `BLUR`: アップロードされた本人確認書類の画像がぼやけています。 `NO_FACE_DETECTED`: 指定された本人確認書類から認識されるはずの顔が、アップロードされた画像から想定どおりに検出されませんでした。 `NOT_REAL_DOC`: アップロードされた本人確認書類の画像が偽造と検出されました。 `EXPOSURE`: アップロードされた本人確認書類の画像が露出オーバーです。 `UNKNOWN`: その他すべての認識エラー。
docErrorDescription	String	オプション。ドキュメント検証の失敗理由を指定します。

spoofResult

次の表は、なりすましチェック結果に含まれる詳細情報を示しています。

フィールド名	データ型	説明
TAMPER_CHECK	String	必須。入力された本人確認書類が改ざんチェックに合格したかどうかを指定します。本人確認書類がチェックに合格しない場合、つまり改ざんされたと検出された場合は、`N` の値が返されます。それ以外の場合、`Y` が返されます。
MATERIAL_CHECK	String	必須。本人確認書類の素材が信憑性チェックに合格したかどうかを指定します。本人確認書類の素材がチェックに合格しない場合、たとえば白黒で検出された場合は、`N` の値が返されます。それ以外の場合、`Y` が返されます。
SCREEN_RECAPTURE_CHECK	String	必須。本人確認書類が画面再キャプチャチェックに合格したかどうかを指定します。本人確認書類がチェックに合格しない場合、つまりアップロードされた画像が画面から再キャプチャされた画像として検出された場合は、`N` の値が返されます。それ以外の場合、`Y` が返されます。
INFORMATION_CHECK	String	(オプション) 現在、HKID (新旧両方のバージョン) のみをサポートしています。本人確認書類が情報チェックに合格したかどうかを示します。「returnFiveCategorySpoofResult」パラメーターが「`Y`」に設定されている場合にのみ返されます。有効な値は次のとおりです。 `Y`: 情報チェックに合格しました。 `N`: 情報チェックに失敗しました。例: ID 番号の桁がエンコードルールと一致しません。
SECURITY_FEATURE_CHECK	String	(オプション) 現在、HKID (新旧両方のバージョン) と MyKad のみをサポートしています。ID がセキュリティ機能チェックに合格したかどうかを示します。「returnFiveCategorySpoofResult」パラメーターが「`Y`」に設定されている場合にのみ返されます。有効な値は次のとおりです。 `Y`: セキュリティ機能チェックに合格しました。 `N`: セキュリティ機能チェックに失敗しました。

extraSpoofResultDetails

次の表は、spoofResultDetails 配列の要素のデータ構造を示しています。

フィールド名	データ型	説明
name	String	必須。詳細なドキュメントなりすましチェックの名前を示します。例: 「landmarkCheckResult」、「hologramCheckResult」
result	String	必須。詳細なドキュメントなりすましチェックの結果を示します。有効な値は次のとおりです。 `Y`: チェックに合格しました `N`: チェックに失敗しました
spoofType	String	必須。詳細なドキュメントなりすましチェックカテゴリを示します。有効な値は次のとおりです。 TAMPER_CHECK MATERIAL_CHECK SCREEN_RECAPTURE_CHECK INFORMATION_CHECK SECURITY_FEATURE_CHECK
components	Array	必須。各コンポーネントのチェック結果が含まれています。常に返されます。指定されたコンポーネントチェックが 1 つだけの場合、配列は 1 つの要素を返します。
components.name	String	必須。コンポーネントの名前を示します。有効な値については、なりすましチェックの詳細ドキュメントを参照してください。
components.subResult	String	必須。コンポーネントの結果を示します。 `Y`: チェックに合格しました `N`: チェックに失敗しました

securityFeaturesResult

このフィールドは非推奨です。詳細については、香港ドキュメント SecurityFeature アップグレード通知 - 2024 年 5 月 31 日 を参照してください。

ExtRiskInfo

次の表は、ExtRiskInfo データモデルで指定できるフィールドを示しています。

フィールド名	データ型	説明
ekycResultRisk	String	リスク管理プロセスの結果を指定します。可能な値とその意味は次のとおりです。 `Success`: リスク管理プロセスは正常に実行されました。 `Pending`: リスク管理プロセスは保留中です。 `Failure`: リスク管理プロセスは失敗しました。
strategyPassResult	String	リスクチェックの結果を指定します。リスク管理プロセスが正常に実行された場合は必須です。可能な値とその意味は次のとおりです。 `PASS`: 本人確認プロセスはリスクチェックに合格しました。 `VELOCITY_HIGH_RISK`: リスク管理エンジンによって高リスクが検出されたことを示します。 `ID_NETWORK_HIGH_RISK`: ID ネットワークチェックによって偽の攻撃リスクが検出されたことを示します。たとえば、複数の ID に関連付けられた顔が検出された場合、または複数の顔に関連付けられた ID が検出された場合などです。注: 類似した顔が同じ ID (ID 番号で識別) または同じユーザー (ユーザー ID で識別) に関連付けられていることが検出された場合、このリスクは報告されません。 `BLACKLIST_HIGH_RISK`: ブラックリストスキャンによって高リスクが検出されたことを示します。 `AGE_MISMATCH_HIGH_RISK`: 年齢検証中に高リスクが検出されたことを示します。
idNetworkDetails	String	オプション。出力に関する詳細情報を指定します。このフィールドは、IdNetworkDetails 構造の JSON シリアル化結果から得られる JSON 文字列です。ID ネットワーク出力では、このフィールドは IdNetworkDetails 構造の JSON シリアル化結果から得られる JSON 文字列です。詳細については、IdNetworkDetails を参照してください。注: このフィールドは、strategyPassResult フィールドが `ID_NETWORK_HIGH_RISK` として返された場合にのみ指定されます。
otherRiskReasonDetails	String	オプション。ID ネットワーク以外のリスクエンジンの詳細出力を指定します。たとえば、ブラックリストヒットの場合、このフィールドの構造は次のようになります。 { "BLACKLIST_HIGH_RISK": { "CERT": [ {"listId":"xx","transactionId":"xx","itemId":xx,"similarScore":xx} ], "FACE":[ {"listId":"xx","transactionId":"xx","itemId":"xx","similarScore":xx} ] } }
deeperRiskResult	String	オプション。詳細なリスク検出結果を指定します。`deeperMode` が CLOSED 以外に設定されている場合に返されます。以下の値が返されます。 `Success`: AIGC 攻撃リスクは検出されていません。 `Failure`: AIGC 攻撃リスクが検出されました。
deeperRiskResultDescription	String	オプション。`deeperMode` が CLOSED 以外に設定され、`deeperRiskResult` が `Failure` を返す場合に、詳細なリスク検出結果の詳細な説明を指定します。
advancedIdnDetail	AdvancedIdnDetail	オプション。IDN によって出力された詳細情報。詳細については、IDN によって出力される詳細情報詳細については、AdvancedIdnDetail を参照してください。注: このパラメーターは、IDN 機能が購入され、`checkAdvancedIdn` フィールド内の initialize で `checkAdvancedIdn` フィールドが
blackListDetails	List<BlackListDetail>	オプション。ブラックリストによって出力された詳細情報。詳細については、ブラックリストによって出力された詳細情報については、BlackListDetail 注: このパラメーターは、ブラックリスト機能を購入し、をでに設定した場合にのみ返されます。`checkBlacklist` フィールド内の初期化 API は `Y`。

IdNetworkDetails

フィールド名	データ型	説明
ekyc_id	String	オプション。非推奨のフィールド。eKYC ID を指定します。
mobile	String	オプション。非推奨のフィールド。携帯電話番号を指定します。
reason_code	Array	オプション。リスクの原因を指定します。 `SIMILAR_FACE`: 類似した顔が複数のユーザー (ユーザー ID で識別) に関連付けられていることが検出されました。注: 類似した顔が同じユーザー (ユーザー ID で識別) に関連付けられていることが検出された場合、このリスクは報告されません。 `SAME_CERT_NO`: 複数のユーザー (ユーザー ID で識別) に関連付けられた ID が検出されました。
type	String	オプション。発生したリスクの種類を指定します。 `Duplicated ID`: 同一人物の複数のドキュメント。 `Fake ID`: ドキュメント情報の改ざん。
score	String	オプション。予約フィールド。予約済みフィールド。値が `type` は重複した ID、このフィールドは返されます。注: このフィールドに依存しないでください。
user_id	String	オプション。加盟店ユーザー ID、または特定のユーザーを識別するために使用できるその他の識別子。

注: RealID に埋め込まれている IDN は、IDN の一部のみを含む合理化されたバージョンの IDN であり、と呼ばれます。IDN Lite。

IDN のすべての機能については、リスクの概要を参照してください。
IDN Lite と IDN の違いについては、ZOLOZ eKYC SaaS に関するよくある質問

リスクタイプと理由コードの紹介

IdNetwork は、2 つの主要なリスク検出タイプをサポートしています。

偽の ID (ドキュメント情報の改ざん)
重複した ID (同一人物の複数のドキュメント)

リスクタイプと理由コードの詳細は、以下の表に示されています。

リスクタイプ	理由コード	説明
Fake ID	SIMILAR_FACE	同じ顔、異なる ID 番号 (同じ ID タイプ)。
Fake ID	SAME_CERT_NO	同じ ID 番号 (同じ ID タイプ)、異なる顔。
Duplicated ID	SIMILAR_FACE	同じ顔、異なる ID タイプ。

AdvancedIdnDetail

フィールド名	データ型	説明
itemId	String	オプション。ID ネットワークデータベースに追加されたレコード ID。後続のリスククエリのために、このレコード ID を保持してください。
riskDetails	List<RiskDetail>	オプション。加盟店が現在直面しているリスクの詳細については、RiskDetail を参照してください。

RiskDetail

フィールド名	データ型	説明	例
type	String	返されたリスクタイプ。詳細については、リスクの概要を参照してください。	"IDFAKE"
subType	String	返されたサブリスクタイプ。詳細については、リスクの概要を参照してください。	"SameFaceDifferentIdNumber"
riskData	List<String>	itemId 配列を含む返されたリスクデータ。	["AIN20220727890199220364"]

BlackListDetail

フィールド名	データ型	説明	例
listId	String	ターゲットブラックリスト ID。	"10064"
itemId	String	ブラックリストレコード ID。	"95c0e4e55d5cd5485edaa573d15e82**"
itemType	String	ブラックリストレコードのタイプ。次の 3 つのタイプがあります。 FACE: 顔ブラックリスト。 CERT: 証明書ブラックリスト。ドキュメントタイプとドキュメント番号で識別されるアイテムを含むドキュメントブラックリスト。 DEVICE: デバイスブラックリスト。	"FACE"
similarScore	String	類似度スコア。スコアが高いほど、類似度は高くなります。	99.99999999999999
transactionId	String	ブラックリストレコードのソース。これは、顧客が eKYC transactionId を介して入力した情報です。	"G000000001FRL202410100000000109481109**"

ExtCustomInfo

フィールド名

データ型

説明

h5Degraded

String

縮退モードが有効かどうかを指定します。有効な値は次のとおりです。

Y: ダウングレードモードが有効です。
N: ダウングレードモードは無効です。

注: このフィールドは、Real ID の allowDegradationパラメーターが設定されていますY 内の Real ID - 初期化 API で

バージョン

日付	変更ログ
2024 年 9 月 20 日	ExtRiskInfo に新しいパラメーター blackListDetails が追加されました。
2024 年 8 月 1 日	Deeper 関連のインターフェース情報の変更。
2024 年 3 月 28 日	新しい出力パラメーター faceAttribute が追加されました。
2023 年 11 月 30 日	IdNetworkDetails とリスクタイプと理由コードの紹介が追加されました
2022 年 5 月 22 日	新しい入力パラメーターextraImageControlList、returnFiveCategorySpoofResult および新しい出力パラメーター追加イメージ、extraSpoofResultDetails が追加されます。
2020 年 10 月 23 日	中国の身分証明書の OCR 結果キーが追加されました。
2020 年 9 月 8 日	さらに 2 つのタイプの本人確認書類がサポートされるようになりました。マレーシア MyKad とマカオの身分証明書。
2020 年 7 月 30 日	レスポンスの ExtIdInfo フィールドに新しいパラメーター securityFeaturesResult が追加されました。現在および新しい HKID の両方に対して、次の 2 つの新しい OCR 結果キーが追加されました。 ISSUE_DATE LATEST_ISSUE_DATE
2020 年 5 月 21 日	現在および新しい HKID に新しい OCR 結果キー SYMBOLS が追加されました。 spoofResult マップに新しいキー OTHER_CHECK が追加されました。
2019 年 12 月 27 日	パラメーター名の大文字と小文字の規則が更新されました。
2019 年 12 月 6 日	リリース。