---
title: "Payments API | Fraud Details"
description: "Reference for KOMOJU's fraud_details object. Pass customer information to reduce chargebacks and improve transaction legitimacy detection."
url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/payments-api-fraud-details"
source_url: "https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/payments-api-fraud-details.md"
language: en
last_modified: "2026-03-25"
---

Similar to [Payment Details](https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/payments-api-payment-details.md), KOMOJU uses a common object called `fraud_details`. This contains personal information about your customer that can help us determine the legitimacy of a transaction. Passing this whenever possible is recommended to reduce chargebacks.

# APIs That Use Fraud Details

- [Payment: Create](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/payments/POST/payments)
- [Session: Pay](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/sessions/POST/sessions/%7Bid%7D/pay)

# The `fraud_details` Object

Any time you see `fraud_details` in an API request, we expect the following format. Note that all of these are optional unless stated otherwise.

| Request Attribute | Type | Description |
| --- | --- | --- |
| `fraud_details[customer_ip]` | string | IPv4 or IPv6-formatted IP address of the customer at the time of payment. Required. |
| `fraud_details[customer_email]` | string | The customer's email address. If `email` was specified on the Session or Payment object, `fraud_details[customer_email]` will default to that value. Required. |
| `fraud_details[customer_id]` | string | Arbitrary unique identifier for your customer. If your system has the concept of user accounts, then the ID of the current logged in user would be appropriate. |
| `fraud_details[browser_language]` | string | Customer's current language setting. |
| `fraud_details[browser_user_agent]` | string | [User-Agent](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent) string. |
| `fraud_details[browser_session_id]` | string | A unique identifier for the current browser session. We expect this to behave similarly to the lifetime of [window.sessionStorage](https://developer.mozilla.org/en-US/docs/Web/API/Window/sessionStorage) in a web browsing context. |
| `fraud_details[phone]` | string | The phone number of the end customer. |