Sign in

v1

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

Cancel fraud marker

The participant who created the fraud marker can call this endpoint. In the case of a fraud marker created as a result of closing an infraction report, the participant who created it can cancel it, in addition to the participant who closed the notification.

On PSP timeout, a 202 Accepted response with a fraud marker ID is returned. 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-status-change-1" >Fraud Marker registration event</a> or <a href="https://developers.pismo.io/events/docs/pix-dict-fraud-marker-status-change-failure-1">failure event</a>.

post/v2/pix/fraud-markers/{id}/cancel

Path parameters

idstring uuid required

Fraud marker ID generated for a suspected fraudelent transaction.

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.

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"
}