# Release History
source: https://developer.mastercard.com/mastercom/documentation/change-logs/index.md

### Release History {#release-history}

This section details the updates implemented to the Mastercom API specifications.
Note: Mastercom decommissioned versions 2, 3, 4 and 5 of the Mastercom API in 2024. Issuers and acquirers must update their systems to version 6 to continue processing disputes.

#### Fees, Fees (Debit MasterCard and Europe Dual Acquirer), Health check {#fees-fees-debit-mastercard-and-europe-dual-acquirer-health-check}

> **Updated** : `POST /v6/claims/{claim-id}/fees/loaddataforfees` ,`POST /v6/claims/{claim-id}/fee/debitmc`, `GET /v6/healthcheck` have been deprecated.   
>
> **Availability date** : April 30, 2026  
>
> **Versions affected** : v6  

#### Claims {#claims}

##### GET /v6/claims/{claim-id} - Response - Added {#get-v6claimsclaim-id---response---added}

> **Field name** : callCenterDetailsUrl  
>
> **Description** : Identifies the Consumer Clarity transaction details URL. This field value is returned only when Consumer Clarity transaction details are available. The URL expires after 15 minutes.   
>
> **Example** : `https://consumerclarity.sample-url`   
>
> **Availability date** : Region specific. July 1, 2026 to November 1, 2026. Refer to [GLB 12896.1 Introducing Ethoca Consumer Clarity Call Center Integration in Mastercom (excluding India, Indonesia, Nepal, Jordan, and Tunisia)](https://trc-techresource.mastercard.com/r/bundle/m_an12896_en-us/page/d/en-US/) in the Technical Resource Center on Mastercard Connect.   
>
> **Versions affected** : v6  

#### Transactions {#transactions}

##### GET /v6/claims/{claim-id}/transactions/clearing/{transaction-id} - Response - Updated {#get-v6claimsclaim-idtransactionsclearingtransaction-id---response---updated}

> **Field name** : mexicoDomesticTaxAmount  
>
> **Description** : The Value Added Tax (VAT) associated with a Mexico domestic transaction.  
>
> **Example** : 002901985000000000121985000000000124  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  
> **Field name** : mexicoDomesticTransactionFeeAmount  
>
> **Description** : The fee amounts associated with a Mexico domestic transaction.  
>
> **Example** : 002901985000000000121985000000000125  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  
> **Field name** : mexicoDomesticSettlementFeesAndVat  
>
> **Description** : Identifies the reconciliation and settlement information for mexicoDomesticTaxAmount and mexicoDomesticTransactionFeeAmount in each Mexico Domestic Dual Message Clearing System transaction with settlement impact.  
>
> **Example** : 002901985000000000121985000000000126  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  

#### Claims {#claims-1}

##### GET /v6/claims/{claim-id} - Response - Updated {#get-v6claimsclaim-id---response---updated}

> **Field name** : chargebackDetails.mexicoDomesticTaxAmount  
>
> **Description** : The Value Added Tax (VAT) associated with a Mexico domestic transaction.  
>
> **Example** : 002901985000000000121985000000000124  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  
> **Field name** : chargebackDetails.mexicoDomesticTransactionFeeAmount  
>
> **Description** : The fee amounts associated with a Mexico domestic transaction.  
>
> **Example** : 002901985000000000121985000000000125  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  
> **Field name** : chargebackDetails.mexicoDomesticSettlementFeesAndVat  
>
> **Description** : Identifies the reconciliation and settlement information for mexicoDomesticTaxAmount and mexicoDomesticTransactionFeeAmount in each Mexico Domestic Dual Message Clearing System transaction with settlement impact.  
>
> **Example** : 002901985000000000121985000000000126  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  
> **Field name** : feeDetails.mexicoDomesticTaxAmount  
>
> **Description** : The Value Added Tax (VAT) associated with a Mexico domestic transaction.  
>
> **Example** : 002901985000000000121985000000000124  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  
> **Field name** : feeDetails.mexicoDomesticTransactionFeeAmount  
>
> **Description** : The fee amounts associated with a Mexico domestic transaction.  
>
> **Example** : 002901985000000000121985000000000125  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  
> **Field name** : feeDetails.mexicoDomesticSettlementFeesAndVat  
>
> **Description** : Identifies the reconciliation and settlement information for mexicoDomesticTaxAmount and mexicoDomesticTransactionFeeAmount in each Mexico Domestic Dual Message Clearing System transaction with settlement impact.  
>
> **Example** : 002901985000000000121985000000000126  
>
> **Availability date** : April 11, 2026  
>
> **Versions affected** : v6  

##### GET /v6/claims/{claim-id} - Response - Updated {#get-v6claimsclaim-id---response---updated-1}

> **Field name** : auditControNumber  
>
> **Description** : Identifier assigned by Mastercom to the fraud reporting event reported through Mastercom. The auditControNumber is used as a reference in the FLD request API to subsequently modify, delete or convert a suspended to a confirmed fraud record and is echoed back.  
>
> **Example** : 123111111000025  
>
> **Availability date** : August 2, 2025  
>
> **Versions affected** : v6  

#### Fraud {#fraud}

##### POST /v6/claims/{claim-id}/fraud/mastercard - Request - Updated {#post-v6claimsclaim-idfraudmastercard---request---updated}

> **Field name** : fraudType  
>
> **Updated** : Valid values updated.  
>
> **Description** : Fraud Type. Valid values: 00, 01, 02, 03 ,04 ,05, 06, 07, 51, 55, 56, 57  
>
> **Example** : 00  
>
> **Availability date** : May 15, 2025  
>
> **Versions affected** : v6  
> **Field name** : subType  
>
> **Updated** : Valid values updated.  
>
> **Description** : Fraud Sub Type. Valid values: K, N, P, U, A, I, V, H, R  
>
> **Example** : K  
>
> **Availability date** : May 15, 2025  
>
> **Versions affected** : v6  

#### Versions 2, 3, 4 and 5 {#versions-2-3-4-and-5}

> **Updated** : Versions 2, 3, 4 and 5 have been decommissioned. Issuers and acquirers must update their systems to version 6.  
>
> **Availability date** : October 1, 2024  
>
> **Versions affected** : v2, v3, v4, v5  

#### Chargebacks {#chargebacks}

##### PUT /v6/chargebacks/acknowledge - Request - Updated {#put-v6chargebacksacknowledge---request---updated}

> **Updated** : Maximum number of chargebacks in chargebackList array.  
>
> **Description** : The maximum number of chargebacks in a request will be 500.  
>
> **Availability date** : October 2024  
>
> **Versions affected** : v4, v5, v6.  

##### PUT /v6/chargebacks/debitmc/acknowledge - Request - Updated {#put-v6chargebacksdebitmcacknowledge---request---updated}

> **Updated** : Maximum number of chargebacks in chargebackList array.  
>
> **Description** : The maximum number of chargebacks in a request will be 500.  
>
> **Availability Date** : October 2024  
>
> **Versions affected** : v6  

##### POST /v6/claims/{claim-id}/chargebacks - Request - Added {#post-v6claimsclaim-idchargebacks---request---added}

> **Field name** : acknowledgeFirstPartyTrustEvidence  
>
> **Description** : The issuer has acknowledged the First-Party Trust evidence and proceeded with the chargeback. Defaults to false. This field is not applicable to second presentments.  
>
> **Example** : true  
>
> **Availability date** : October 27, 2024  
>
> **Versions affected** : v6  

#### Claims {#claims-2}

##### GET /v6/claims/{claim-id} - Response -- Added" {#get-v6claimsclaim-id---response--added}

> **Field name** : chargebackDetails.acknowledgeFirstPartyTrustEvidence  
>
> **Description** : The issuer has acknowledged the First-Party Trust evidence and proceeded with the chargeback.  
>
> **Example** : true  
>
> **Availability date** : October 27, 2024  
>
> **Versions affected** : v6