---
title: "Create dispute fraud report"
method: POST
path: "/v1/disputes/{disputeId}/fraud-report"
tags: ["Supporting forms"]
---

# Create dispute fraud report

`POST /v1/disputes/{disputeId}/fraud-report`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/v1/disputes/{disputeId}/fraud-report`
- Auth: none declared

Create a dispute fraud report and one related installment.

## Path parameters

- `disputeId` number, required

## Request body

- DisputeFraudReportRequest: Request used to create a Dispute Fraud Report with success.
  - `dispute_installment_id` number: Related dispute installment ID. If not passed, first Installment is used.
  - `report` DisputeFraudReportDocumentStructure, required
    - `acct_status` 'ACCT_IS_OPEN' | 'ACCT_HAS_BEEN_CLOSED', required: Account status
    - `chgbk_indicator` '0' | '1', required: Is this a chargeback? true = `1`, false = `0`.
    - `cvc_invalid_indicator` 'Y' | '*' | 'M' | 'N' | 'P' | 'U' | '?' | 'E', required: Mastercard <a href='https://developer.mastercard.com/fld-fraud-submission/documentation/parameters/annexure-1/#table-15-card-validation-code-cvc-indicator' target='_blank'>CVC invalid code indicator</a>
    - `device_type` '1' | '2' | '3' | '4' | 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J', required: Mastercard <a href='https://developer.mastercard.com/fld-fraud-submission/documentation/parameters/annexure-1/#table-3-account-device-type-codes' target='_blank'>account device type</a>.
    - `fraud_type` '00' | '01' | '02' | '03' | '04' | '05' | '06' | '07' | '08' | '09' | '10' | '11' | '51' | '55' | '56' | '57', required: Mastercard <a href='https://developer.mastercard.com/fld-fraud-submission/documentation/parameters/annexure-1/#table-1-fraud-type-codes' target='_blank'>fraud type codes</a>
    - `report_date` string, required: Fraud report date, format = yyyy-mm-dd.
    - `sub_type` 'K' | 'N' | 'P' | 'U', required: Mastercard <a href='https://developer.mastercard.com/fld-fraud-submission/documentation/parameters/annexure-1/#table-2-fraud-sub-type-codes' target='_blank'>fraud sub type codes</a>
    - `authorization_origin_indicator` 'Y' | 'X' | 'N', nullable: Authorization origin indicator, default is null. **REQUIRED** for ELO network.<br> `Y` - Issuer authorized<br> `X` - Parameter authorized<br> `N` - Not Authorized<br>
    - `notification_code` '1' | '2' | '3' | '4' | '5', nullable: Notification type code. Default is null. **REQUIRED** for ELO network.<br> `1` - First notification<br> `2` - Notification sent again<br> `3` - Change<br> `4` - Deletion (cancellation fraud warning)<br> `5` = Reactivation<br>
    - `exchange_indicator` 'N' | 'Y': Is this an exchange? Default is `N`. **REQUIRED** for ELO network.<br> `Y` - Yes<br> `N` - No<br>
    - `exchange_value` number: Exchange value. **REQUIRED** for ELO network.
    - `card_service_code` 'C' | 'M': Card type. **REQUIRED** for ELO network.<br> `C` - Chip<br> `M` - Stripe<br>

## Response `200`

OK

- DisputeFraudReportResponse: Dispute fraud report resonse
  - `fraud_report_id` number: Dispute fraud report ID.
  - `dispute_id` number: Dispute ID
  - `dispute_installment_id` number: Dispute installment related to dispute fraud report.

## Other responses

- `401`: Access token is missing or invalid
- `404`: Not Found
- `422`: Unprocessable entity
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)
