メインコンテンツへスキップ

サイレント認証

MarkdownChatGPTClaude

サイレント認証を使用すると、以前に検証済みの再来訪ユーザーが、キャプチャ画面を表示することなくカード非提示認証の取引を完了できます。ユーザーに新しいセルフィーを求める代わりに、Unicoのテクノロジーがバックグラウンドでシグナルと再来訪の履歴を評価し、取引をサイレントに承認できるかどうかを判断します。

サイレント認証は別個のプロダクトではなく、決済取引およびクレジットカードOnboardingで説明されている、同じ取引作成フローの上に追加される1つのステップです。SDKでコンテキストシグナルを収集し、取引作成時に同じ外部キーを送信することが、サイレント承認の可能性を実現します。

適用条件
  • サイレント認証は、Unicoのテクノロジーがシグナルを通じてそのユーザーを評価できるだけの十分な履歴がある場合に適用されます。
  • 履歴不足などの理由でこの評価ができない場合、取引は標準の画面表示フローにフォールバックします。これは、たとえばあるユーザーがネットワーク上で初めて確認された場合などに起こり得ます。
1. SDKでデバイスメタデータを収集する

通常どおり、お使いのプラットフォーム用のCapture SDKをインストールして初期化してください — サイレント認証によってこのセットアップが変わることはありません。externalUserIdを送信するために、各プラットフォームのMonitoring Data Collectionガイドに従ってください。

情報

Flutterはまだサイレント認証に対応していません。

ここでは単なる観測用メタデータではありません

Monitoring Data Collectionガイドでは、externalUserIdは「SDKのキャプチャ動作やAPIレスポンスを変更しない」任意のテレメトリとして説明されています。それはSDK単体としては事実です。カード非提示認証では、この同じフィールドを使って、バックエンドが取引をサイレントに承認できるかどうかを判断します。 これを送信することが、その取引に対してサイレント認証を有効にする条件であり、ここでは無関係な項目ではありません。

2. 同じexternalUserIDで取引を作成する

externalUserIDは任意ですが、これがない場合、その取引に対してサイレント認証は行われません。取引を作成する際 — 決済取引またはクレジットカードOnboarding経由 — SDKで使用したものとまったく同じexternalUserIDを、additionalInfo内に含めて送信してください。

{
  "additionalInfo": {
    "externalUserID": "YOUR_EXTERNAL_USER_ID"
  }
}

省略してもエラーにはなりません — 取引は通常どおり作成され、単に常に視覚的な摩擦を伴う標準フローに従うだけです。

3. レスポンスを処理する

取引が条件を満たし、サイレントに承認された場合、それ以上の対応は不要です。

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "approved"
}

それ以外の場合、レスポンスには標準の画面表示フローを完了するためのlinkが含まれます。これは、サイレント認証なしで作成された取引とまったく同じです。

{
  "id": "6ab1771e-dfab-4e47-8316-2452268e5481",
  "status": "waiting",
  "link": "https://aces.so/example",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cC[...]Ok6yJV_adQssw5c"
}

その他のステータスについては、返されたlinkを使用して標準フローに従ってください。ステータスの全リストについては、エクスペリエンスの制御と列挙値をご覧ください。

最終更新 に