# Fraud Data Add (FDA) Flow – Minimal
source: https://developer.mastercard.com/fld-fraud-submission/documentation/use-cases/use-cases/fda-minimal/index.md

This service enables the initiator to submit a Mastercard built transaction as fraudulent in FLD. The FDA retrieves the transaction details from the Mastercard transaction Data Warehouse (DWH), based on the values provided in the request payload.

### Workflow {#workflow}

1. The cardholder reports a fraudulent transaction to the issuer.
2. The issuer or processor (on behalf of the issuer) uses the FDA API to add a fraud record in FLD ((POST) `/fld/confirmed-frauds/mastercard-frauds`).
   * The system authenticates the request and forwards it to the FLD for processing.
3. If authentication fails, the FDA rejects the request and returns a response to the issuer or processor.
4. Mastercard FLD performs schema checks and business validations.
   * If schema or business validation fails during processing, the FDA sends an appropriate response back to the user.
5. After successful validation, FLD searches the transaction in the Mastercard repository.
6. The FDA decrypts the request data before the FLD processes it.
7. Once it finds the transaction, FLD extracts and stores the associated details in its system.
8. The FLD generates a unique Audit Control Number (ACN) and includes it in the response for future reference.
9. Mastercard Gateway sends a success response to the issuer or processor.

Diagram fda_flow

## Endpoint {#endpoint}

| **API Call**  |                    **URI**                    | **Response** |
|---------------|-----------------------------------------------|--------------|
| FDA (Minimal) | POST `fld/confirmed-frauds/mastercard-frauds` | HTTP: 200 OK |

## Sample Request Message {#sample-request-message}

    {
       "refId":"ecb2d942-eabd-42b6-87fd-69c19692bdc6",
       "timestamp":"2021-03-16T20:34:37-06:00",
       "icaNumber":"1076",
       "providerId":"10",
       "transactionIdentifiers":[
          {
             "cfcKey":"ARN",
             "cfcValue":"11111111119999999999999"
          },
          {
             "cfcKey":"BRN",
             "cfcValue":"999RRR"
          }
       ],
       "cardNumber":"5505135664572870008",
       "transactionAmount":"5505",
       "transactionDate":"20200713",
       "fraudPostedDate":"20210316",
       "fraudTypeCode":"01",
       "fraudSubTypeCode":"N",
       "accountDeviceType":"1",
       "cardholderReportedDate":"20210314",
       "cardInPossession":"Y",
       "avsResponseCode":"U",
       "authResponseCode":"00",
       "memo":"This is a sample FDA minimal request.",
       "issuerSCAExemption":"02"
       }

## Sample Success Response Message {#sample-success-response-message}

    {
       "refId":"ecb2d942-eabd-42b6-87fd-69c19692bdc6",
       "timestamp":"2021-03-16T20:34:40-06:00",
       "responseCode":"000",
       "responseMessage":"Success",
       "icaNumber":"1076",
       "auditControlNumber":"123111111000025",
       "currentStatus":"CONFIRMED-SUCCESS",
       "matchLevelIndicator":"M",
       "financialTransactionIndicator":"DECLINED",
       "authorizationResponse":"05 - Do not honor"
    }

## Sample Failure Response Message {#sample-failure-response-message}

    {
       "refId":"ecb2d942-eabd-42b6-87fd-69c19692bdc6",
       "timestamp":"2021-03-16T20:34:40-06:00",
       "responseCode":"100",
       "responseMessage":"Failure",
       "errorDetails":{
          "Errors":{
             "Error":[
                {
                   "ReasonCode":"60004",
                   "Description":"cardNumber attribute value length not in range. Minimum Length:12 and Maximum Length: 19."
                }
             ]
          }
       }
    }