Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Anti-fraud

Create fraud marker

Creates a fraud marker.

On PSP timeout, a 202 Accepted response is returned with a fraud marker ID. The process continues asynchronously and, if it doesn't succeed, a failure event is emitted.

This endpoint generates a <a href="https://developers.pismo.io/events/docs/pix-dict-fraud-marker-registration-1" >Fraud Marker registration event</a> or <a href="https://developers.pismo.io/events/docs/pix-dict-fraud-marker-registration-failure-1">failure event</a>.

post/v2/pix/fraud-markers

Headers

Authorizationstring required
Example:Bearer eyJhbGci...IUzUx

Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in a <b>401 Unauthorized</b> message.

Idempotency-Keystring required

A unique ID to ensure the operation remains idempotent, allowing for operation repitition without causing unintended effects or duplication. An idempotent operation is one that can be applied multiple times, yet the outcome remains the same. it ensures that network errors, retries, or failures can occur without introducing inconsistencies.

Response

OK

idstring uuid required

Fraud marker ID

document_numberstring required

Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.

fraud_type'APPLICATION_FRAUD' | 'MULE_ACCOUNT' | 'SCAMMER_ACCOUNT' | 'OTHER' | 'UNKNOWN' required

Verified fraud type

status'REGISTERED' | 'CANCELLED' required

Fraud marker status

keystring

Key to which the fraud marker will be associated. It must be reported, if known

bacen_creation_datetimestring date-time required

Date of infraction report creation. RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

bacen_last_modified_datetimestring date-time required

Date of infraction report modification. RFC 3339 date-time value. For example - 2023-04-12T23:20:50.52Z.

Example response

{
  "id": "ea8bc045-9ff7-439f-a318-2e6f974707a5",
  "document_number": "7777888hh",
  "fraud_type": "APPLICATION_FRAUD",
  "status": "REGISTERED",
  "bacen_creation_datetime": "2020-08-13T13:49:03Z",
  "bacen_last_modified_datetime": "2020-08-13T13:49:03Z"
}