顔写真チェックを追加する

書類チェックでは、不正な本人確認書類の使用を未然に防ぐことができますが、不正行為者は盗んだ本物の書類を使用する可能性があります。これを防ぐために、Stripe Identity はユーザーに対して顔写真チェックを行うことができます。

顔写真チェックでは、写真付き身分証明書とユーザーの顔写真から、顔の形などの生物学的特徴を検出します。次に、Stripe で高度な機械学習アルゴリズムを使用して、その顔写真が同一人物のものであることを確認します。

アプリケーションに顔写真チェックを追加するには、まずガイドに従って本人確認書類を収集し確認します。

VerificationSessions に顔写真チェックを追加する

VerificationSession を作成する際、options.document.require_matching_selfie パラメーターを使用して顔写真チェックを有効にします。

curl https://api.stripe.com/v1/identity/verification_sessions \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d type=document \
  -d "options[document][require_matching_selfie]"=true

これにより認証フローが設定され、ユーザーは写真付き身分証明書と顔写真を求められます。

顔写真チェックの結果にアクセスする

送信と処理が終わると、VerificationSession ステータスは、チェックの結果に応じて変化します。

• verified: 書類と顔写真の両方のチェックが完了しました。セッションの verified_outputs には、書類から抽出された情報が含まれます。
• requires_input — 書類または顔写真のチェックのうち、少なくとも一方が失敗しました。

記録された顔写真と書類の画像にアクセスするには、関連する VerificationReport を取得する必要があります。これを実行するには、以下のセッションで last_verification_report フィールドを拡張します。

// Set your secret key. Remember to switch to your live secret key in production.
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = require('stripe')(
'sk_test_4eC39HqLyjWDarjtT1zdp7dc');
const verificationSession = await stripe.identity.verificationSessions.retrieve(
  '{{SESSION_ID}}',
  {
    expand: ['last_verification_report'],
  }
);
const verificationReport = verificationSession.last_verification_report;

VerificationReport には、書類と顔写真のチェック結果を含む document および selfie のフィールドがあります。以下は、書類と顔写真のチェックに成功した VerificationReport の例です。

{
  "id": "vr_1eeUEvVKopIV53HzBsyjfSGn",
  "object": "identity.verification_report",
  "type": "document",
  "verification_session": "vs_xAGraQ66r4HDUFVEVTIWJYo3",
  "created": 1611776872,
  "livemode": true,
  "options": {
    "document": {
      "require_matching_selfie": true
    }
  },
  "document": {
    "status": "verified",
    "error": null,
    "first_name": "Jenny",
    "last_name": "Rosen",
    "address": {
      "line1": "1234 Main St.",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94111",
      "country": "US"
    },
    "document_type": "id_card",
    "expiration_date": {
      "day": 17,
      "month": 7,
      "year": 2024
    },
    "files": ["file_ObnMx8rEkVZMz4Dr247YAlUQ", "file_mL3YKmxZCGyn3lNr6YiRCysF"],
    "issued_date": {
      "day": 4,
      "month": 27,
      "year": 2021
    },
    "issuing_country": "US"
  },
  "selfie": {
    "status": "verified",
    "error": null,
    "document": "file_p8SDLNXrtlVSKBoBLiQGoI11",
    "selfie": "file_2ElnwsS2BuBgBJfZdvduKiCz",
  }
}

収集された書類と顔の画像にアクセスするには、確認結果へのアクセスをご覧ください。

顔写真チェックの失敗について

VerificationReport の document および selfie のフィールドには、収集されたデータに加え、チェックの成否を知るのに役立つ status と error のフィールドが含まれます。

status フィールドで、各チェックが成功したかどうかが分かります。表示される可能性のある値は以下のとおりです。

• verified: 本人確認チェックは成功し、収集されたデータは確認されました。
• unverified: 本人確認チェックは失敗しました。詳細については、error ハッシュを参照してください。

本人確認チェックが失敗すると、error フィールドに、確認失敗の理由を説明する code と reason の値が含まれます。error.code フィールドを使用して、確認の失敗をプログラムで処理することができます。reason フィールドには失敗の理由を説明するメッセ―ジが含まれ、ユーザーに提示できます。

書類チェックの失敗

失敗の詳細はレポートの document.error フィールドに表示されます。

顔写真チェックの失敗

失敗の詳細はレポートの selfie.error フィールドに表示されます。