Report confirmed fraud

curl --request POST \ --url https://sandbox.clausum.ai/api/v1/report-fraud \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "payment_id": "pi_3Nxyz", "provider": "stripe", "reason": "chargeback", "description": "Issuer chargeback received, code 10.4", "ip_address": "201.150.10.22" } '

{ "success": true, "data": { "case": { "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "reference_number": "CLM-LX9A2B", "status": "<string>", "priority": "<string>" }, "transaction": { "id": "<string>", "external_id": "<string>", "is_fraudulent": true }, "blocklist": { "entries_added": 123, "types": [ "<string>" ] } } }

Authorizations

Authorization

string

header

default:clm_sk_your_secret_key

required

Partner secret or publishable key, e.g. clm_sk_... or clm_pub_... (assess only).

Body

application/json

reason

enum<string>

required

Available options:

chargeback,

friendly_fraud,

card_testing,

account_takeover,

identity_theft,

other

transaction_id

string

Clausum internal transaction UUID, if known.

payment_id

string

PSP payment id (same as assess payment_id).

external_transaction_id

string

Deprecated alias of payment_id.

provider

string

Example:

"stripe"

amount

number

Required only when no transaction is referenced.

currency

string

string<email>

card_bin

string

card_last4

string

ip_address

string

description

string

evidence_urls

string<uri>[]

notify

object

Show child attributes

Response

Fraud report processed

success

boolean

data

object

Show child attributes

Overview

Endpoints

Report confirmed fraud

Authorizations

Body

Response