# FDE Request and Response source: https://developer.mastercard.com/fld-fraud-submission/documentation/parameters/fde-req-res/index.md ## FDE Request {#fde-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 | | ICA number of the originator initiating the FDE request. | 1076 | | providerId | 2 | 2 | ENUM | Mandatory | | Indicates the originator of the request. Possible values are: * 10 for Issuer * 20 for Acquirer For the following scenarios, this value will be '10': * Issuer and Acquirer for a transaction is the same entity * FDD or FDE operation is performed on a Issuer-built record | 10 | | 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 to subsequently modify, delete or convert a suspended to a confirmed fraud record. | 418142102142002 | | operationType | 1 | 50 | ENUM | Mandatory | | Indicates the type of operation to be performed for the given audit control number. Possible value is 'FDE'. | FDE | | memo | 1 | 1000 | ANS | Optional | | Brief description by the originator providing some comment supporting the action. Following special characters are not allowed - '\^','-','#','%','=','\*','!',';','\<',' | ','\>','+','/' and Space | ## FDE Response {#fde-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 provided in the request API which is echoed 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 - SUSPENDED' This attribute will be absent if the request is not processed by FLD application. | CONFIRMED - SUSPENDED | | 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 | | 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. | |