詐欺の詳細
決済の詳細と同様に、KOMOJUはfraud_details
という共通オブジェクトを使用します。これには、取引の正当性を判断するのに役立つお客様の個人情報が含まれています。チャージバックを減らすために、可能な限りこれを渡することが推奨されます。
詐欺の詳細を使用するAPI
fraud_details
オブジェクト
fraud_details
オブジェクトAPIリクエストにfraud_details
が表示される場合は常に、次のフォーマットを想定しています。特に断りのない限り、これらはすべてオプションであることに注意。
Request Attribute | タイプ | 説明 |
---|---|---|
fraud_details[customer_ip] | string | 決済時のお客様のIPv4またはIPv6形式のIPアドレス。必須です。 |
fraud_details[customer_email] | string | お客様のEメールアドレス。email がセッションオブジェクトまたはペイメントオブジェクトで指定されている場合、fraud_details[customer_email] はデフォルトでその値に設定されます。必須です。 |
fraud_details[customer_id] | string | 顧客の任意の一意の識別子。システムにユーザアカウントの概念がある場合は、現在ログインしているユーザのIDが適切となります。 |
fraud_details[browser_language] | string | お客様の現在の言語設定。 |
fraud_details[browser_user_agent] | string | User-Agent文字列。 |
fraud_details[browser_session_id] | string | 現在のブラウザセッションの一意の識別子。これは、Webブラウジングコンテキストにおける[window.sessionStorage](https://developer.mozilla.org/en-US/docs/Web/API/Window/sessionStorage) の有効期間と同様に動作することを期待しています。 |
fraud_details[phone] | string | 最終顧客の電話番号。 |
Updated 7 months ago