# FDC (Complete) Request and Response source: https://developer.mastercard.com/fld-fraud-submission/documentation/parameters/fdc-req-res-complete/index.md ## FDC (Complete) Request {#fdc-complete-request} | **Attribute name** | **Min length** | **Max length** | **Data type** | **Presence** | **Default value** | **Field description** | **Example** | |------------------------------|----------------|----------------|---------------|--------------|-------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------| | refId | 36 | 36 | ANS | Mandatory | | Unique identification generated by the transaction originator using UUID logic to unambiguously link a request and response message. The only special character allowed will be '-'. | ecb2d942-eabd-42b6-87fd-69c19692bdc6 | | timestamp | 29 | 29 | DATE | Mandatory | | Timestamp of the request initiation by the originator in the format 'YYYY-MM-DDThh:mm:ss' or 'YYYY-MM-DDThh:mm:ss+hh:mm'. The value of '+hh:mm' portion should always be '-06:00' reflecting CST time. | 2021-02-01T20:34:37-06:00 | | icaNumber | 3 | 7 | N | Mandatory | 9999999 - Unknown | ICA number of the originator initiating the FDC request. If Issuer ID is unknown, then the default value to be provided as input will be '9999999'. | 1076 | | auditControlNumber | 15 | 15 | N | Mandatory | | Unique number generated by FLD application and provided in the response message for a successful fraud record submission ('FDA' event). This is used as a reference in the request API to subsequently modify, delete or convert a suspended to a confirmed fraud record and is echoed back. This attribute will be absent if the request is not processed by FLD application. | 418142102142002 | | acquirerId | 3 | 7 | N | Optional | 9999999 - Unknown | Acquirer identification number (ICA number) for the transaction. If Acquirer ID is unknown, then the default value to be provided as input will be '9999999'. | 5450 | | cardNumber | 12 | 19 | N | Optional | | Cardholder account number used in the fraudulent transaction. Do not include leading zeros. Card number to be verified through Luhn's algorithm. | 5505135664572870008 | | fraudTypeCode | 2 | 2 | AN | Optional | | Code identifying the reason the originator submitted the transaction as fraud in FLD. Refer to 'Table 1' in 'Annexure 1' tab for possible values. | 04 | | fraudSubTypeCode | 1 | 1 | A | Optional | U - Unknown | Code to further identify the reason that the originator submitted the transaction as fraud in FLD. Refer to 'Table 2' in 'Annexure 1' tab for possible values. | U | | cardProductCode | 3 | 3 | A | Optional | | Value identifying the type of card used in the transaction. Refer to 'Table 1' in 'Annexure 2' tab for possible values. | MSI | | transactionDate | 8 | 8 | DATE | Optional | | Local date at the merchant location when the transaction occurred and accepted in CST format. Format is 'YYYYMMDD'. | 20210115 | | settlementDate | 8 | 8 | DATE | Optional | | Settlement date of transaction reported. Format is 'YYYYMMDD'. | 20210116 | | fraudPostedDate | 8 | 8 | DATE | Optional | | Date on which the transaction was posted as fraudulent at the customer's site. Format is 'YYYYMMDD'. | 20210120 | | cardholderReportedDate | 8 | 8 | DATE | Optional | | Date on which the cardholder had reported the fraud. Format is 'YYYYMMDD'. | 20210118 | | transactionAmount | 1 | 12 | N | Optional | | This is the amount of funds the cardholder requested in the local currency of the acquirer or source location of the transaction. Value should be without decimals considering the local currency exponent value. | 10350 | | transactionCurrencyCode | 3 | 3 | N | Optional | | Code defining the currency used for the transaction amount. The code should be part of the numeric ISO Standard Currency Codes list. | 826 | | billingAmount | 1 | 12 | N | Optional | | Amount appearing on the cardholder statement in the cardholder's billing currency (without any decimals). | 10350 | | billingCurrencyCode | 3 | 3 | N | Optional | | Code defining the currency used for the billing amount. The code should be part of the numeric ISO Standard Currency Codes list. | 826 | | merchantId | 1 | 15 | ANS | Mandatory | \* - Unknown | Card acceptor / merchant's unique identification number, assigned by the Acquirer. Only '\*', '/', '-' and space allowed as special character | A42E51982100100 | | merchantName | 1 | 22 | ANS | Mandatory | | Name of the card acceptor name. All special characters are allowed. | BANKNEWPORT | | merchantCity | 1 | 13 | ANS | Mandatory | UNKNOWN - Unknown | City in which the merchant is located.The only special character allowed will be space. | PHOENIX | | merchantStateProvinceCode | 1 | 3 | ANS | Conditional | UN - Unknown | If the card acceptor / merchant is in the US, the state in which it is located. | AZ | | merchantCountryCode | 3 | 3 | ANS | Mandatory | UNK - Unknown | Indicates the country in which the merchant is located. | USA | | merchantPostalCode | 1 | 10 | ANS | Mandatory | \* - Unknown | Postal code at the merchant location.Only '\*', '-' allowed as special character | 85001 | | terminalAttendanceIndicator | 1 | 1 | N | Optional | 9 - Unknown or unspecified | Indicates if the card acceptor was attending the terminal at the time of transaction. Refer to 'Table 12' in 'Annexure 1' tab for possible values. | 1 | | terminalId | 1 | 8 | ANS | Optional | 99999999 - Unknown | Unique code identifying a terminal at the card acceptor (merchant) location. | 5055D305 | | terminalOperatingEnvironment | 1 | 1 | N | Optional | 9 - Unknown | Indicates whether the card acceptor is attending the terminal and the location of the terminal. Refer to 'Table 13' in 'Annexure 1' tab for possible values. | 4 | | cardholderPresenceIndicator | 1 | 1 | N | Optional | 9 - Unknown or unspecified | Indicates whether the cardholder is present at the point of service and explains the condition if the cardholder is not present. Refer to 'Table 6' in 'Annexure 1' tab for possible values. | 5 | | cardPresenceIndicator | 1 | 1 | N | Optional | 9 - Unknown | Indicates whether the card was present at the point of service. Refer to 'Table 7' in 'Annexure 1' tab for possible values. | 1 | | cardInPossession | 1 | 1 | ENUM | Optional | U - Unknown | Flag to indicate if the card holder was in possession of the card at the time the fraud occurred. Possible values are 'Y', 'N' and 'U'. | N | | catLevelIndicator | 1 | 1 | NS | Mandatory | \* - Unknown or unspecified | Indicates whether the cardholder activated the terminal with the use of the card and the CAT security level. Refer to 'Table 9' in 'Annexure 1' tab for possible values. Only '\*' allowed as special character. | 1 | | terminalCapabilityIndicator | 1 | 1 | AN | Mandatory | 0 - Unknown or unspecified | Indicates the terminal capability for transferring the data on the card into the terminal. Refer to 'Table 14' in 'Annexure 1' tab for possible values. | 5 | | electronicCommerceIndicator | 1 | 2 | NS | Conditional | \* - Unknown or unspecified | Indicates the security protocol and authentication of the transaction. Mandatory if CAT Level = 6. Refer to 'Table 10' in 'Annexure 1' tab for possible values. Only '\*' allowed as special character. | 24 | | posEntryMode | 2 | 2 | AN | Optional | 00 - Unknown | Indicates how the PAN was entered at the terminal. Refer to 'Table 8' in 'Annexure 1' tab for possible values. | 05 | | cvcInvalidIndicator | 1 | 1 | AS | Mandatory | For CNP: ? - Unknown or unspecified For CP: \* - Unknown or unspecified | Indicates whether the CVC was valid when authorization was attempted. Refer to 'Table 15' in 'Annexure 1' tab for possible values. Only '\*' and '?' are allowed as special character. | M | | avsResponseCode | 1 | 1 | A | Optional | U - Unknown | The Address Verification Service response code in the Authorization Request Response. Refer to 'Table 4' in 'Annexure 1' tab for possible values. | U | | authResponseCode | 2 | 2 | AN | Optional | 40 - Unknown | Indicates the result of the authorization request. Refer to 'Table 5' in 'Annexure 1' tab for possible values. | 01 | | secureCode | 1 | 1 | N | Optional | 9 - Unknown | Indicates the type of security processing used for the PIN data. Refer to 'Table 11' in 'Annexure 1' tab for possible values. Mandatory if ecommerce indicator = 21 or 22. | 9 | | accountDeviceType | 1 | 1 | AN | Optional | | Indicates if the account uses a magnetic stripe, chip, pin, contactless or any combination thereof. Refer to 'Table 3' in 'Annexure 1' tab for possible values. | 1 | | memo | 1 | 1000 | ANS | Optional | | Brief description by the originator providing some comment supporting the action. Following special characters are not allowed - '\^','-','#','%','=','\*','!',';','\<',' | ','\>','+','/' and Space | | issuerSCAExemption | 1 | 2 | N | Optional | | Issuer SCA(Strong Customer Authentication) Exemption value. | | | transactionIndicator | 4 | 4 | ANS | Optional | | Indicates whether the transaction was initiated by the cardholder or the merchant. | M101 | ## FDC (Complete) Response {#fdc-complete-response} | **Attribute name** | **Min length** | **Max length** | **Data type** | **Presence** | **Field description** | **Example** | |-----------------------------------|----------------|----------------|---------------|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | refId | 36 | 36 | ANS | Mandatory | Unique identification generated by the transaction originator in the request API which is echoed back to link a request and response message. | ecb2d942-eabd-42b6-87fd-69c19692bdc6 | | timestamp | 29 | 29 | DATE | Mandatory | Timestamp of the response initiation by Mastercard in the format 'YYYY-MM-DDThh:mm:ss+hh:mm'. The value of '+hh:mm' portion should always be '-06:00' reflecting CST time. | 2021-02-01T20:34:40-06:00 | | responseCode | 3 | 3 | N | Mandatory | Response code indicating success or failure of the transaction at an API level. Errors at a record level will be handled through 'errorDetails' element associated with each record. | 000 | | responseMessage | 1 | 100 | ANS | Mandatory | Transaction response description corresponding to the response code. | Success | | icaNumber | 3 | 7 | N | Conditional | ICA number of the originator present in the transaction is sent back. This attribute will be absent if the request is not processed by FLD application. | 1076 | | auditControlNumber | 15 | 15 | N | Conditional | Unique number generated by FLD application and provided in the response message for a successful fraud record submission ('FDA' event). This is used as a reference in the request API to subsequently modify, delete or convert a suspended to a confirmed fraud record and is echoed back. This attribute will be absent if the request is not processed by FLD application. | 418142102142002 | | previousStatus | 1 | 50 | ENUM | Conditional | Indicates the previous status of the fraud record being submitted. Possible values are: * 'CONFIRMED - SUCCESS' * 'CONFIRMED - REJECTED' This attribute will be absent if the request is not processed by FLD application. | CONFIRMED - REJECTED | | currentStatus | 1 | 50 | ENUM | Conditional | Indicates the current status of the fraud record being submitted. Possible values are: * 'CONFIRMED - SUCCESS' * 'CONFIRMED - REJECTED' * 'CONFIRMED - SUSPENDED' This attribute will be absent if the request is not processed by FLD application. | CONFIRMED - SUCCESS | | matchLevelIndicator | 1 | 1 | ENUM | Conditional | Indicates if it is a Mastercard-built or Issuer-built record. Possible values are: * 'M' if Mastercard-built * 'I' if Issuer-built This attribute will be absent if the request is not processed by FLD application. | M | | financialTransactionIndicator | 1 | 20 | ENUM | Conditional | Indicates if the fraud record is being submitted against a financial transaction (having a clearing record) or a declined auth transaction (without a clearing record). Possible values are: * 'APPROVED' for financial transaction (having a clearing record) * 'DECLINED' for declined auth transaction (without a clearing record) This attribute will be absent in case of match not found in Data Warehouse and transaction processed as Issuer Built transaction. | DECLINED | | authorizationResponse | 1 | 200 | ANS | Conditional | Provides the 'Auth Response Code' and 'Auth Response Code Description' combination only if 'Financial Transaction Indicator' value is 'DECLINED'. This attribute will be absent for all other scenarios. | 05 - Do not honor | | errorDetails -\> Errors -\> Error | NA | NA | NA | Conditional | Array list containing the combination of error reason codes and their corresponding description. It will be absent if the request is processed by FLD application successfully. | * Code ```code "errorDetails":{ "Errors":{ "Error":[ { "ReasonCode":"60002", "Description":"timestamp attribute or attribute value is missing or incorrect." } ] } } ``` | | ReasonCode | 5 | 5 | N | Conditional | Error code indicating the reason for the failure of a particular record. | | | Description | 1 | 1000 | ANS | Conditional | Description corresponding to the error reason code. | |