---
title: "詐欺の詳細"
description: "KOMOJUのfraud_detailsオブジェクトのリファレンスです。チャージバックを減らし取引の正当性を向上させるために顧客情報を渡します。"
url: "https://docs.komoju.com/ja/docs/integration-guides/payments-api-fraud-details"
source_url: "https://docs.komoju.com/ja/docs/integration-guides/payments-api-fraud-details.md"
language: ja
last_modified: "2026-03-31"
---

[決済の詳細](https://docs.komoju.com/ja/docs/integration-guides/payments-api-payment-details.md)と同様に、KOMOJUは`fraud_details`という共通オブジェクトを使用します。これには、取引の正当性を判断するのに役立つお客様の個人情報が含まれています。チャージバックを減らすために、可能な限りこれを渡することが推奨されます。

# 詐欺の詳細を使用するAPI

[ペイメント: 作成](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/payments/POST/payments)

[セッション: 決済](https://docs.komoju.com/ja/api-reference#2025-01-28/tag/sessions/POST/sessions/%7Bid%7D/pay)

# `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](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/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 | 最終顧客の電話番号。 |