# Testing
source: https://developer.mastercard.com/mastercom/documentation/testing/index.md

Use this page to plan and execute Sandbox validation for the Mastercom API. It covers the recommended workflow, positive and negative coverage, and the reference guides you need for endpoint-level execution.
Tip: Start all validation in Sandbox before moving to Production. Sandbox URL: `https://sandbox.api.mastercard.com` Note: See [How to Consume the Mastercom API?](https://developer.mastercard.com/mastercom/documentation/api-basics/index.md#how-to-consume-the-mastercom-api) to check on the multiple ways to integrate with Mastercom.

### Choose a testing method {#choose-a-testing-method}

Choose a testing method that best matches how you want to validate requests:

* [Postman Collection](https://developer.mastercard.com/mastercom/documentation/developer-tools/postman-collection/index.md) --- an API client that allows developers to test API's calls in Sandbox and production environments without writing any code.
* [Insomnia Collection](https://developer.mastercard.com/mastercom/documentation/developer-tools/insomnia-collection/index.md) --- an alternative API client that developers use to quickly and easily send REST requests to Mastercard APIs.
* [Reference Application](https://developer.mastercard.com/mastercom/documentation/developer-tools/reference-app/index.md) --- a working implementation that allows you to integrate different operations.

## Recommended testing flow {#recommended-testing-flow}

1. Search for transactions
2. Claims
3. Chargeback
4. Queues
5. Case Filing
6. Fraud
7. Retrievals
8. Reconciliation
9. Chargebacks (Debit Mastercard and Europe Dual Acquirer)
10. Retrievals (Debit Mastercard and Europe Dual Acquirer)
11. Transactions (Debit Mastercard and Europe Dual Acquirer)
12. Fees

### Required Parameters {#required-parameters}

For some API calls, one or more parameters might be needed in the URI while sending the request (for example, claim-id), check below where these parameters can be extracted from:

|      Parameter       |                                                                                                                                                                                                                                                                             Resources used to retrieve parameter                                                                                                                                                                                                                                                                             |
|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **case-id**          | \[Create Case\](/documentation /testing/#create-case) can be used to create a new case-id.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **claim-id**         | [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id. [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.                                                                                                  |
| **chargeback-id**    | [Create Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-chargeback) can be used to create a new chargeback-id. [Create Debit MC Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-debit-mc-chargeback) can be used to create a new Debit Mastercard and Europe Dual Acquirer chargeback-id. [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) to retrieve an existing chargeback-id associated with a claim.                                |
| **queue-name**       | [Retrieve Queue Names](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-queue-names) can be used to retrieve a queue-name.                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **request-id**       | [Create Retrieval Request](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-retrieval-request) can be used to create a new request-id. [Create Debit MC Retrieval Request](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-debit-mc-retrieval-request) can be used to create a new Debit Mastercard and Europe Dual Acquirer request-id. [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) can be used to retrieve an existing request-id associated with a claim. |
| **reportIdentifier** | [Reconciliation Acknowledge](https://developer.mastercard.com/mastercom/documentation/testing/index.md#reconciliation-acknowledge) can be used to generate a new reportIdentifier.                                                                                                                                                                                                                                                                                                                                                                                                           |
| **transaction-id**   | [Transaction Search](https://developer.mastercard.com/mastercom/documentation/testing/index.md#transaction-search) can be used to retrieve a transaction-id.                                                                                                                                                                                                                                                                                                                                                                                                                                 |

Note: See our [Latest API Specification](https://developer.mastercard.com/mastercom/documentation/api-reference/v6-reference/index.md) for detailed info on each API Call.

## Positive testing {#positive-testing}

Positive testing confirms that valid requests succeed and return the expected data.

### Validate these behaviors {#validate-these-behaviors}

* Valid request bodies return success codes, such as `200 OK`, `201 Created`, or `204 No Content`.
* Created resources can be retrieved by ID or found through search.
* Updates persist and can be verified with a follow-up GET.
* Search and filter parameters return the expected subset of records.

## 1. Transactions {#1-transactions}

### Transaction Search {#transaction-search}

|        API Call        |                     Description                      |             URI              |   Response   |
|------------------------|------------------------------------------------------|------------------------------|--------------|
| Search for transaction | This resource is used to query for transaction data. | POST /v6/transactions/search | HTTP: 200 OK |

* Json

```json
{
  "acquirerRefNumber": "05436847276000293995738",
  "primaryAccountNum": "5488888888887192",
  "transAmountFrom": "10000",
  "transAmountTo": "20050",
  "tranStartDate": "2026-06-22",
  "tranEndDate": "2026-06-22"
}
```

* Json

```json
{
  "authorizationSummaryCount": "1",
  "message": "Search returned 1 records.",
  "authorizationSummary": [
    {
      "originalMessageTypeIdentifier": "0110",
      "banknetDate": "250822",
      "transactionAmountUsd": "164.77",
      "primaryAccountNumber": "5488888888887192",
      "processingCode": "00",
      "transactionAmountLocal": "000000016477",
      "authorizationDateAndTime": "0822122535",
      "track2": "Y201",
      "authenticationId": "236972",
      "cardAcceptorName": "Ace Hardware",
      "cardAcceptorCity": "PORTLAND",
      "cardAcceptorState": "OR",
      "track1": "Y101",
      "currencyCode": "840",
      "chipPresent": "N",
      "transactionId": "X5D0sB-V7OpVfoiBjUsKmq-olwILV6KmX0ABpzECbCCmSJzlll8DcP_4EC6LBytENGuzxo5VOGmBMrsKj-gRk==",
      "clearingSummary": [
        {
          "primaryAccountNumber": "5488888888887192",
          "transactionAmountLocal": "16477",
          "dateAndTimeLocal": "250822122535",
          "cardDataInputCapability": "C",
          "cardholderAuthenticationCapability": "1",
          "cardPresent": "0",
          "acquirerReferenceNumber": "05436847276000293995738",
          "cardAcceptorName": "Ace Hardware",
          "currencyCode": "840",
          "transactionId": "ARGmzwyBbgzqTh1TqZdQr_qIyy1npyTywC9CUL4__TipNmozcjdC56_iMMUk+4M2bs-exd3tKDxZNeCRzt6Pr==",
          "installmentPaymentDataBrazil": "7320247136478772095100064784250521690386464285477149521",
          "settlementIndicator": "M",
          "messageReversalIndicator": "R"
        }
      ]
    }
  ]
}
```

### Retrieve Clearing Details {#retrieve-clearing-details}

Before Retrieve Transaction Clearing Details, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Transaction Search](https://developer.mastercard.com/mastercom/documentation/testing/index.md#transaction-search) can be used to retrieve transaction-id.

|         API Call         |                                Description                                 |                               URI                                |   Response   |
|--------------------------|----------------------------------------------------------------------------|------------------------------------------------------------------|--------------|
| Retrieve clearing detail | This resource is used to retrieve clearing detail for a given transaction. | GET /v6/claims/{claim-id}/transactions/clearing/{transaction-id} | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654/transactions/clearing/FIEaEgnM3bwPijwZgjc3Te+Y0ieLbN9ijUugqNSvJmVbO1xs6Jh5iIlmpOpkbax79L8Yj1rBOWBACx+Vj17rzvOepWobpgWNJNdsgHB4ag

no body
* Json

```json
{
  "accountLevelManagementAccountCategoryCode": "Y",
  "acquirerReferenceData": "51032462590187224368495",
  "acquiringInstitutionIdCode": "198701",
  "approvalCode": "39199B",
  "businessCycle": "01",
  "businessServiceArrangementTypeCode": "2",
  "businessServiceIdCode": "529653",
  "cardAcceptorBusinessCode": "7140",
  "cardAcceptorCity": "SAN FRANCISCO",
  "cardAcceptorClassificationOverrideIndicator": "N",
  "cardAcceptorCountry": "USA",
  "cardAcceptorIdCode": "603752933005",
  "cardAcceptorName": "Discount Tire",
  "cardAcceptorPostalCode": "94108",
  "cardAcceptorState": "CA",
  "cardAcceptorStreetAddress": "6456 RIVER WAY",
  "cardAcceptorTerminalId": "5317",
  "cardAcceptorUrl": "www.discounttire.com",
  "cardCaptureCapability": "9",
  "cardDataInputCapability": "D",
  "cardDataInputMode": "A",
  "cardDataOutputCapability": "1",
  "cardholderAuthenticationCapability": "1",
  "cardholderAuthenticationEntity": "4",
  "cardholderAuthenticationMethod": "0",
  "cardholderBillingAmount": "42748877",
  "cardholderBillingCurrencyCode": "840",
  "cardholderFromAccountCode": "00",
  "cardholderPresentData": "0",
  "cardholderToAccountCode": "00",
  "cardIssuerReferenceData": "3502646606",
  "cardPresentData": "0",
  "cardProgramIdentifier": "MCC",
  "centralSiteBusinessDate": "260609",
  "centralSiteProcessingDateOriginalMessage": "844459",
  "currencyCodeCardholderBilling": "840",
  "currencyCodeReconciliation": "840",
  "currencyCodeTransaction": "840",
  "currencyExponentCardholderBilling": "2",
  "currencyExponentReconciliation": "2",
  "currencyExponentTransaction": "2",
  "dataRecord": "0",
  "electronicCommerceCardAuth": "1",
  "electronicCommerceSecurityLevelIndicator": "2",
  "electronicCommerceUcafCollectionIndicator": "0",
  "forwardingInstitutionIdCode": "158668",
  "functionCode": "200",
  "gcmsProductIndentifier": "MPL",
  "installmentAmount": "71248.13",
  "installmentNumber": "3",
  "installmentFee": "1200",
  "installmentParameters": {
    "deferredGracePeriodFlag": "1",
    "deferredGracePeriodMonths": "0",
    "issuerPromotion": "1"
  },
  "installmentPaymentData": "92",
  "installmentPaymentDataAnnualPercentageRate": "0",
  "installmentPaymentDataFirstInstallmentAmount": "71248.13",
  "installmentPaymentDataInstallmentFee": "0",
  "installmentPaymentDataInterestRate": "1.5",
  "installmentPaymentDataNumberInstallments": "6",
  "installmentPaymentDataSubsequentInstallmentAmount": "71248.13",
  "installmentPlanType": "21",
  "integratedCircuitCardRelatedData": "100",
  "interchangeRateDesignator": "14",
  "licensedProductIndentifier": "MPL",
  "legalCorporateName": "Discount Tire",
  "localMessageReasonCode": "130",
  "localTax1IVA": "006",
  "localTransactionDateTime": "260609073000",
  "mastercardAssignedId": "771106",
  "mastercardAssignedIdOverrideIndicator": "Y",
  "mastercardMappingServiceAccountNumber": "5123430317858605751",
  "masterPassIncentiveIndicator": "N",
  "messageReasonCode": "8708",
  "messageReversalIndicator": "",
  "numberOfInstallments": "6",
  "originalInformationInstallments": {
    "amountOfPurchase": "42748877",
    "transactionInterestRate": "1.5",
    "installmentAmount": "71248.13"
  },
  "originatingMessageFormat": "1",
  "partnerIdCode": "G5",
  "pinCaptureCapability": "1",
  "primaryAccountNumber": "5123430317858605751",
  "processingCode": "00",
  "productOverrideIndicator": "N",
  "interchangeStructureIndicatorOverride": "B1",
  "programRegistrationId": "N1C",
  "qpsPaypassEligibilityIndicator": "I",
  "rateIndicator": "N",
  "receivingInstitutionIdCode": "722695",
  "reconciliationAmount": "42748877",
  "reconciliationCurrencyCode": "840",
  "remotePaymentsProgramData": "9",
  "serviceCode": "200",
  "settlementData": "       94030016618046                  1US00000001N1647046727261339",
  "settlementIndicator": "M",
  "specialConditionsIndicator": "Y",
  "terminalDataOutputCapability": "1",
  "terminalOperatingEnvironment": "1",
  "terminalType": "NA",
  "tokenRequestorId": "K4QLD3R224",
  "totalTransactionAmount": "427488.77",
  "transactionAmountLocal": "42748877",
  "transactionCategoryIndicator": "01",
  "transactionCurrencyCode": "840",
  "transactionDestinationInstitutionIdCode": "735496",
  "transactionLifeCycleId": "MKOP558HZ5567",
  "transactionOriginatorInstitutionIdCode": "134612",
  "transactionType": "Clearing",
  "transitProgramCode": "86",
  "walletIdentifierMdes": "586",
  "flexCode": "VHA",
  "installmentPaymentDataBrazil": "6950240397298936304431587526897023351675831238228401811",
  "installmentData": "1261610E81023498764532103",
  "additionalAmountDataCode": "96943430620944707737;81239334161232091298;74427991301714650644",
  "currencyConversionAssessmentAmount": "000000021250",
  "japanCommonMerchantCode": "0415",
  "mexicoDomesticTaxAmount": "002901985000000000121985000000000124",
  "mexicoDomesticTransactionFeeAmount": "002901985000000000121985000000000125",
  "mexicoDomesticSettlementFeesAndVat": "002901985000000000121985000000000126"
}
```

### Retrieve authorization details {#retrieve-authorization-details}

Before Retrieve Transaction Authorization Details, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Transaction Search](https://developer.mastercard.com/mastercom/documentation/testing/index.md#transaction-search) can be used to retrieve transaction-id.

|           API Call            |                                   Description                                    |                                  URI                                  |   Response   |
|-------------------------------|----------------------------------------------------------------------------------|-----------------------------------------------------------------------|--------------|
| Retrieve authorization detail | This resource is used to retrieve authorization details for a given transaction. | GET /v6/claims/{claim-id}/transactions/authorization/{transaction-id} | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654/transactions/authorization/FIEaEgnM3bwPijwZgjc3Te+Y0ieLbN9ijUugqNSvJmVbO1xs6Jh5iIlmpOpkbax79L8Yj1rBOWBACx+Vj17rzvOepWobpgWNJNdsgHB4ag

No body
* Json

```json
{
  "accountNumber": "5123430513576318326",
  "accountNumberIndicator": "I",
  "acquirer": "N",
  "acquiringInstitutionCountryCode": "USA",
  "acquiringInstitutionId": "155423",
  "addressVerificationServiceResponse": "Z",
  "adviceReasonCode": "461",
  "atcDiscrepancyIndicator": "G",
  "atcDiscrepancyValue": "20931",
  "atcValue": "38887",
  "authenticationIndicator": "0",
  "authorizationIdResponse": "208128",
  "banknetDate": "260616",
  "banknetReferenceNumber": "WF9SLV",
  "billingCurrencyCode": "840",
  "cardAcceptorCity": "PHILADELPHIA",
  "cardAcceptorId": "5761146284486",
  "cardAcceptorName": "BJ's Wholesale Club",
  "cardAcceptorState": "PA",
  "cardAcceptorTerminalId": "30712387",
  "cardholderActivatedTerminalLevel": "6",
  "cardholderBillingActualAmount": "000070040934",
  "cardholderBillingAmount": "000070040934",
  "cardAuthenticationMethodValidationCode": "M",
  "conversionDate": "0616",
  "conversionRate": "61000000",
  "electronicCommerceIndicators": "2362365",
  "electronicCommerceSecurityLevelIndicatorAndUcafCollectionIndicator": "0",
  "finalAuthorizationIndicator": "0",
  "financialNetworkCode": "MCC",
  "forwardingInstitutionId": "439008",
  "infData": "3452817109729855",
  "integratedCircuitCardRelatedData": "266",
  "issuer": "Y",
  "mastercardPromotionCode": "H6ED5N",
  "mccMessageId": "FOGJ",
  "merchantAdviceCode": "01",
  "mobilePhoneNumber": null,
  "mobilePhoneServiceProviderName": null,
  "originalAcquiringInstitutionIdCode": "145781",
  "originalElectronicCommerceSecurityLevelIndicatorAndUcafCollectionIndicator": "16",
  "originalIssuerForwardingInstitutionIdCode": "638812",
  "originalMessageTypeIdentifier": "0110",
  "pinServiceCode": "TV",
  "realTimeSubstantiationIndicator": "1",
  "reasonForUcafCollectionIndicatorDowngrade": "478",
  "posCardDataTerminalInputCapability": "0",
  "posCardholderPresence": "1",
  "posCardPresence": "1",
  "posEntryModePan": "35",
  "posEntryModePin": "10",
  "posTerminalAttendance": "1",
  "posTerminalLocation": "0",
  "posTransactionStatus": "0",
  "primaryAccountNumber": "5123430513576318326",
  "primaryAccountNumberAccountRange": "512343051",
  "privateData": "38038405002UU90220107ACQREG10207ISSREG17104C2C 102101920CM04020CM0402S1I13530411000000000000501006040CVA07040CXL00031440101R0201A4011SN402RG123A42430106GLBALL02050000103021704020105021606020041280110019 020 355734557649379111289515",
  "processingCode": "00",
  "recordDataPresenceIndicator": "N",
  "responseCode": "00",
  "retrievalReferenceNumber": "545732014229",
  "settlementActualAmount": "000070040934",
  "settlementDate": "0616",
  "stan": "550166",
  "storageTechnology": "07",
  "systemsTraceAuditNumber": "ZB14HD",
  "tokenAssuranceLevel": "174",
  "tokenRequestorId": "QYUZ1O137T",
  "track1": "N",
  "track2": "Y201",
  "transactionActualAmount": "000070040934",
  "transactionAmountLocal": "000070040934",
  "transactionCategoryCode": "T",
  "transactionCurrencyCode": "840",
  "transactionType": "Authorization",
  "transmissionDateAndTime": "0616082515",
  "universalCardholderAuthenticationFieldUcaf": "PARTIALSHIPMENT0000000000000ALrP9TrnbuMCAANkrglrAoABFA==ACFa0knOekU7AAnwugwJAoABFA==ICQk7mTHQKqwx9tKqqY=hgeiVCYsZLM8YwAAAFcqCVkAAAA=hgeiVCYsZLM8YwAAAIFuCEYAAAA=hmJA2XBYTaCdCAEAABneT94HJ4M=",
  "vcnProductCode": "MC4",
  "walletIdentifier": "117",
  "expirationDatePresenceInd": "N",
  "merchantCategoryCode": "MCW"
}
```

## 2. Claims {#2-claims}

### Create Claim {#create-claim}

|   API Call   |            Description             |       URI       |   Response   |
|--------------|------------------------------------|-----------------|--------------|
| Create claim | This resource creates a new claim. | POST /v6/claims | HTTP: 200 OK |

* Json

```json
{
  "disputedAmount": "100.00",
  "disputedCurrency": "USD",
  "claimType": "Standard",
  "clearingTransactionId": "ccCnaMDqmto4wnL+BSUKSdzROqGJ7YELoKhEvluycwKNg3XTzSfaIJhFDkl9hW081B5tTqFFiAwCpcocPdB2My4t7DtSTk63VXDl1CySA8Y="
}
```

* Json

```json
{
  "claimId": "200002029057"
}
```

### Retrieve Claim {#retrieve-claim}

Before Retrieve Claim, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|    API Call    |                Description                 |            URI            |   Response   |
|----------------|--------------------------------------------|---------------------------|--------------|
| Retrieve claim | This resource retrieves a claim's details. | GET /v6/claims/{claim-id} | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654

No body
* Json

```json
{
  "acquirerId": "000390",
  "acquirerRefNum": "51032462590739732062828",
  "primaryAccountNum": "5123439706914898142",
  "claimId": "200002020654",
  "claimType": "Standard",
  "claimValue": "822.94 GBP",
  "standardClaims": null,
  "clearingDueDate": "2026-06-25",
  "clearingNetwork": "GCMS",
  "createDate": "2026-06-18",
  "dueDate": "2026-06-25",
  "transactionId": "VsC4QIbwLA_kIdIB0YP+2jQXBl2j86Bo3ArwhBi529yJ89J6l7+Apnbg0uMxsXDuuzh30u2Kz3As4A8RsbOLK==",
  "isAccurate": "true",
  "isAcquirer": "true",
  "isIssuer": "false",
  "isOpen": "true",
  "issuerId": "009357",
  "lastModifiedBy": "system",
  "lastModifiedDate": "2026-06-23",
  "merchantId": "002403766043",
  "queueName": "Acquirer RR Unworked",
  "switchSerialNumber": "197975900",
  "retrievalDetails": {
    "acquirerRefNum": "51032462590739732062828",
    "acquirerResponseCd": "C",
    "acquirerMemo": "Acquirer response to fulfillment",
    "acquirerResponseDt": "2026-06-19",
    "amount": "822.94",
    "currency": "GBP",
    "claimId": "200002020654",
    "issuerResponseCd": "REJECT_DOCUMENTATION_NOT_AS_REQUIRED",
    "issuerRejectRsnCd": "P",
    "issuerMemo": "Issuer response to fulfillment",
    "issuerResponseDt": "2026-06-19",
    "imageReviewDecision": "I",
    "imageReviewDt": "2026-06-19",
    "primaryAcctNum": "5123439706914898142",
    "requestId": "25859694",
    "retrievalRequestReason": "6343",
    "docNeeded": "2",
    "createDate": "2026-06-19",
    "chargebackRefNum": "9000039493",
    "cancelDate": "2026-06-19",
    "rejectDate": "2026-06-19",
    "reverseDate": "2026-06-19",
    "rejectReason": "Code1=0142(00):D0063/002;DE072=D0063\\8000000808\\\\",
    "instructionsForHealthcare": null,
    "refundReversalType": "REFUND",
    "refundReversalAmount": "822.94",
    "refundReversalCurrency": "GBP",
    "refundReversalDate": "2026-06-19",
    "refundReversalReferenceId": "106650565",
    "memo": "Memo information",
    "flexCode": "TVC",
    "collaborationExpirationDateTime": "2026-06-18T18:27:39",
    "acquirerResponseNotificationStatus": "Processed"
  },
  "chargebackDetails": [
    {
      "currency": "GBP",
      "documentIndicator": "false",
      "messageText": "Chargeback message",
      "amount": "822.94",
      "reasonCode": "4808",
      "isPartialChargeback": false,
      "chargebackType": "CHARGEBACK",
      "chargebackId": "300003030280",
      "claimId": "200002020654",
      "reversed": false,
      "reversal": false,
      "createDate": "2026-06-20",
      "chargebackRefNum": "9000039493",
      "documentStatus": "DOC_NOT_APPLICABLE",
      "rejectReason": "Code1=5000(00):D0025/000;DE072=D0025\\0000\\\\",
      "editExclusionCode": "BO",
      "refundNotReceivedIndicator": "true",
      "creditVoucherStatus": "Credit Voucher Accepted",
      "currencyConversionAssessmentCCAIncluded": "true",
      "currencyConversionAssessmentCCAAmount": "8.63 GBP",
      "japanCommonMerchantCode": "0410",
      "installmentData": "1261610E81023498764532103",
      "flexCode": "TVC",
      "acknowledgeFirstPartyTrustEvidence": "true",
      "reconciliationAmount": "822.94",
      "reconciliationCurrency": "GBP",
      "mexicoDomesticTaxAmount": "002901985000000000121985000000000124",
      "mexicoDomesticTransactionFeeAmount": "002901985000000000121985000000000125",
      "mexicoDomesticSettlementFeesAndVat": "002901985000000000121985000000000126"
    },
    {
      "currency": "GBP",
      "documentIndicator": "false",
      "messageText": "Second presentment message",
      "amount": "822.94",
      "reasonCode": "2002",
      "isPartialChargeback": false,
      "chargebackType": "SECOND_PRESENTMENT",
      "chargebackId": "300003030280",
      "claimId": "200002020654",
      "reversed": false,
      "reversal": false,
      "createDate": "2026-06-20",
      "chargebackRefNum": "9000039493",
      "documentStatus": "DOC_NOT_APPLICABLE",
      "rejectReason": "Code1=5000(00):D0025/000;DE072=D0025\\0000\\\\",
      "editExclusionCode": "BO",
      "currencyConversionAssessmentCCAIncluded": "true",
      "currencyConversionAssessmentCCAAmount": "8.63 GBP",
      "japanCommonMerchantCode": "0410",
      "installmentData": "1261610E81023498764532103",
      "flexCode": "TVC",
      "reconciliationAmount": "822.94",
      "reconciliationCurrency": "GBP",
      "mexicoDomesticTaxAmount": "002901985000000000121985000000000124",
      "mexicoDomesticTransactionFeeAmount": "002901985000000000121985000000000125",
      "mexicoDomesticSettlementFeesAndVat": "002901985000000000121985000000000126"
    }
  ],
  "feeDetails": [
    {
      "cardAcceptorIdCode": "137822716345159",
      "cardNumber": "5123439706914898142",
      "countryCode": "ITA",
      "currency": "GBP",
      "feeDate": "2026-06-21",
      "destinationMember": "000390",
      "feeAmount": "2.30",
      "creditSender": "true",
      "creditReceiver": "false",
      "message": "Message regarding fee",
      "reason": "7623",
      "feeId": "30002055596",
      "chargebackRefNum": "9000039493",
      "rejectReason": "Code1=0142(00):D0063/002;DE072=D0063\\\\8000000808\\\\\\\\",
      "japanCommonMerchantCode": "0410",
      "installmentData": "1261610E81023498764532103",
      "flexCode": "TVC",
      "reconciliationAmount": "2.30",
      "reconciliationCurrency": "GBP",
      "mexicoDomesticTaxAmount": "002901985000000000121985000000000124",
      "mexicoDomesticTransactionFeeAmount": "002901985000000000121985000000000125",
      "mexicoDomesticSettlementFeesAndVat": "002901985000000000121985000000000126"
    }
  ],
  "caseFilingDetails": {
    "caseFilingStatus": "Closed",
    "caseFilingDetails": {
      "claimId": "200002020654",
      "claimType": "Standard",
      "caseId": "5415899",
      "caseType": "1",
      "chargebackRefNum": [
        "9000039493"
      ],
      "currencyCode": "GBP",
      "customerFilingNumber": "9357",
      "disputeAmount": "822.94",
      "dueDate": "2026-06-22",
      "filingAgaintstIca": "0390",
      "filingAs": "I",
      "filingIca": "9357",
      "merchantName": "Save-A-Lot",
      "primaryAccountNum": "5123439706914898142",
      "violationCode": null,
      "violationDate": null,
      "rulingDate": "2026-06-22",
      "rulingStatus": "V",
      "virtualAccountNum": "5123439715714338796",
      "creditDate": "2026-06-22",
      "chargebackDate": "2026-06-20",
      "reasonCode": "4808"
    },
    "caseFilingRespHistory": [
      {
        "memo": "Case filing response",
        "action": "ACCEPT",
        "responseDate": "2026-06-22"
      }
    ]
  },
  "retrievalDetailsList": [
    {
      "acquirerRefNum": "51032462590739732062828",
      "acquirerResponseCd": "C",
      "acquirerMemo": "Acquirer response to fulfillment",
      "acquirerResponseDt": "2026-06-19",
      "amount": "822.94",
      "currency": "GBP",
      "claimId": "200002020654",
      "issuerResponseCd": "REJECT_DOCUMENTATION_NOT_AS_REQUIRED",
      "issuerRejectRsnCd": "P",
      "issuerMemo": "Issuer response to fulfillment",
      "issuerResponseDt": "2026-06-19",
      "imageReviewDecision": "I",
      "imageReviewDt": "2026-06-19",
      "primaryAcctNum": "5123439706914898142",
      "requestId": "25859694",
      "retrievalRequestReason": "6343",
      "docNeeded": "2",
      "createDate": "2026-06-19",
      "chargebackRefNum": "9000039493",
      "cancelDate": "2026-06-19",
      "rejectDate": "2026-06-19",
      "reverseDate": "2026-06-19",
      "rejectReason": "Code1=0142(00):D0063/002;DE072=D0063\\8000000808\\\\",
      "instructionsForHealthcare": null,
      "refundReversalType": "REFUND",
      "refundReversalAmount": "822.94",
      "refundReversalCurrency": "GBP",
      "refundReversalDate": "2026-06-19",
      "refundReversalReferenceId": "106650565",
      "memo": "Memo information",
      "flexCode": "TVC",
      "collaborationExpirationDateTime": "2026-06-18T18:27:39",
      "acquirerResponseNotificationStatus": "Processed"
    }
  ],
  "auditControlNumber": "123115559051743",
  "callCenterDetailsUrl": "https://example.com/callcenterdetails/200002020654"
}
```

### Update Claim {#update-claim}

Before Update Claim, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|   API Call   |          Description           |            URI            |   Response   |
|--------------|--------------------------------|---------------------------|--------------|
| Update claim | This resource updates a claim. | PUT /v6/claims/{claim-id} | HTTP: 200 OK |

PUT /mastercom/v6/claims/200002020654
* Json

```json
{
  "openClaimDueDate": "2026-02-20",
  "action": "CLOSE",
  "closeClaimReasonCode": "10"
}
```

* Json

```json
{
  "claimId": "200002020654"
}
```

## 3. Chargeback {#3-chargeback}

### Create Chargeback {#create-chargeback}

Before Create Chargeback, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|     API Call      |               Description               |                  URI                   |   Response   |
|-------------------|-----------------------------------------|----------------------------------------|--------------|
| Create chargeback | This resource creates a new chargeback. | POST /v6/claims/{claim-id}/chargebacks | HTTP: 200 OK |

* Json

```json
{
  "amount": "100.00",
  "chargebackType": "CHARGEBACK",
  "currency": "USD",
  "documentIndicator": "false",
  "reasonCode": "4853",
  "credPostedAsPurchase": false,
  "isPartialChargeback": false,
  "messageText": "This is a test message text",
  "settlementDate": "2026-06-26",
  "localTax1IVA": "0.60",
  "installmentFee": 1.2,
  "editExclusionCode": "BO",
  "refundNotReceivedIndicator": "true",
  "includeCurrencyConversionAssessmentCCA": "true",
  "acknowledgeFirstPartyTrustEvidence": "false"
}
```

* Json

```json
{
  "chargebackId": "300003030419"
}
```

### Create Chargeback Reversal {#create-chargeback-reversal}

Before Create Chargeback Reversal, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.  

[Create Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-chargeback) can be used to create a new chargeback-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) to retrieve an existing chargeback-id associated with a claim.

|          API Call          |                 Description                  |                               URI                               |   Response   |
|----------------------------|----------------------------------------------|-----------------------------------------------------------------|--------------|
| Create chargeback reversal | This resource creates a chargeback reversal. | POST /v6/claims/{claim-id}/chargebacks/{chargeback-id}/reversal | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/chargebacks/300018439680/reversal

No body
* Json

```json
{
  "chargebackId": "300003030649"
}
```

### Get Possible Values for Chargeback {#get-possible-values-for-chargeback}

Before Get Possible Values for Chargeback, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|              API Call              |                                         Description                                         |                              URI                              |   Response   |
|------------------------------------|---------------------------------------------------------------------------------------------|---------------------------------------------------------------|--------------|
| Get possible values for chargeback | This resource retrieves a structure containing possible values used to create a chargeback. | POST /v6/claims/{claim-id}/chargebacks/loaddataforchargebacks | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/chargebacks/loaddataforchargebacks
* Json

```json
{
  "chargebackType": "CHARGEBACK"
}
```

* Json

```json
{
  "currencies": [
    {
      "name": "EUR",
      "value": "EUR"
    },
    {
      "name": "USD",
      "value": "USD"
    }
  ],
  "docIndicators": [
    {
      "name": "0",
      "value": "0 - No supporting documentation is provided."
    },
    {
      "name": "1",
      "value": "1 - Supporting documentation will follow."
    }
  ],
  "messageTexts": [
    {
      "name": "INVESTIGATION",
      "value": "INVESTIGATION"
    }
  ],
  "reasonCodes": [
    {
      "name": "4807",
      "value": "4807 - Warning Bulletin File"
    },
    {
      "name": "4808",
      "value": "4808 - Authorization-Related Chargeback"
    },
    {
      "name": "4812",
      "value": "4812 - Account Number Not on File"
    },
    {
      "name": "4831",
      "value": "4831 - Transaction Amount Differs"
    },
    {
      "name": "4834",
      "value": "4834 - Point of Interaction Error"
    },
    {
      "name": "4837",
      "value": "4837 - No Cardholder Authorization"
    },
    {
      "name": "4840",
      "value": "4840 - Fraudulent Processing of Transactions"
    },
    {
      "name": "4841",
      "value": "4841 - Cancelled Recurring and Digital Goods Transactions"
    },
    {
      "name": "4842",
      "value": "4842 - Late Presentment"
    },
    {
      "name": "4846",
      "value": "4846 - Correct Transaction Currency Code Not Provided"
    },
    {
      "name": "4849",
      "value": "4849 - Questionable Merchant Activity"
    },
    {
      "name": "4850",
      "value": "4850 - Installment Billing Dispute"
    },
    {
      "name": "4853",
      "value": "4853 - Cardholder Dispute"
    },
    {
      "name": "4854",
      "value": "4854 - Cardholder Dispute.Not Elsewhere Classified (U.S. Region Only)"
    },
    {
      "name": "4855",
      "value": "4855 - Goods or Services Not Provided"
    },
    {
      "name": "4859",
      "value": "4859 - No-Show, Addendum, or ATM Dispute"
    },
    {
      "name": "4860",
      "value": "4860 - Credit Not Processed"
    },
    {
      "name": "4863",
      "value": "4863 - Cardholder Does Not Recognize.Potential Fraud"
    },
    {
      "name": "4870",
      "value": "4870 - Chip liability shift"
    },
    {
      "name": "4871",
      "value": "4871 - Chip Liability Shift - Lost/Stolen/Never Received Issue (NRI) Fraud"
    },
    {
      "name": "4880",
      "value": "4880 - Chip Read POS Late Presentment"
    },
    {
      "name": "4999",
      "value": "4999 - Domestic Chargeback Dispute Reserved for intra-European use"
    }
  ],
  "amount": {
    "name": "EUR",
    "value": "0.68"
  }
}
```

### Retrieve Chargeback Documentation {#retrieve-chargeback-documentation}

Before Retrieve Chargeback Documentation, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.  

[Create Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-chargeback) can be used to create a new chargeback-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) to retrieve an existing chargeback-id associated with a claim.

|             API Call              |                       Description                       |                               URI                               |   Response   |
|-----------------------------------|---------------------------------------------------------|-----------------------------------------------------------------|--------------|
| Retrieve chargeback documentation | This resource retrieves documentation for a chargeback. | GET /v6/claims/{claim-id}/chargebacks/{chargeback-id}/documents | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654/chargebacks/300018439680/documents?format=ORIGINAL\&Format=JSON

No body
* Json

```json
{
  "fileAttachment": {
    "filename": "CB_300018439680.zip",
    "file": "{base 64 string}"
  }
}
```

### Update Chargeback {#update-chargeback}

Before Update Chargeback, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.  

[Create Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-chargeback) can be used to create a new chargeback-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) to retrieve an existing chargeback-id associated with a claim.

|     API Call      |             Description             |                          URI                          |   Response   |
|-------------------|-------------------------------------|-------------------------------------------------------|--------------|
| Update chargeback | This resource updates a chargeback. | PUT /v6/claims/{claim-id}/chargebacks/{chargeback-id} | HTTP: 200 OK |

PUT /mastercom/v6/claims/200002020654/chargebacks/300018439680
* Json

```json
{
  "memo": "This is a test memo",
  "fileAttachment": {
    "filename": "testimage111111.tif",
    "file": "This is an image file stored in a base64 encoded string"
  }
}
```

* Json

```json
{
  "chargebackId": "300018439680"
}
```

### Acknowledge Received Chargebacks {#acknowledge-received-chargebacks}

|             API Call             |                       Description                       |               URI               |   Response   |
|----------------------------------|---------------------------------------------------------|---------------------------------|--------------|
| Acknowledge received chargebacks | This resource marks a received chargeback as processed. | PUT /v6/chargebacks/acknowledge | HTTP: 200 OK |

* Json

```json
{
  "chargebackList": [
    {
      "claimId": "200002020654",
      "chargebackId": "300018439680"
    }
  ]
}
```

* Json

```json
{
  "chargebackResponseList": [
    {
      "chargebackId": "300014887392",
      "status": "PROCESSED",
      "failureReason": null
    }
  ]
}
```

### Retrieve Chargeback Status {#retrieve-chargeback-status}

|          API Call          |                          Description                           |            URI             |   Response   |
|----------------------------|----------------------------------------------------------------|----------------------------|--------------|
| Retrieve chargeback status | This resource retrieves the processing status of a chargeback. | PUT /v6/chargebacks/status | HTTP: 200 OK |

* Json

```json
{
  "chargebackList": [
    {
      "claimId": "200002020654",
      "chargebackId": "300018439680"
    }
  ]
}
```

* Json

```json
{
  "chargebackResponseList": [
    {
      "claimId": "200002020654",
      "chargebackId": "300018439680",
      "status": "RELEASED"
    }
  ]
}
```

## 4. Queues {#4-queues}

### Retrieve Queue Names {#retrieve-queue-names}

|       API Call       |                  Description                   |         URI          |   Response   |
|----------------------|------------------------------------------------|----------------------|--------------|
| Retrieve queue names | This resource retrieves a list of queue names. | GET /v6/queues/names | HTTP: 200 OK |

No body
* Json

```json
[
  {
    "queueName": "Rejects",
    "queueDescription": "Rejects"
  },
  {
    "queueName": "IssuerRepresentmentUnworked",
    "queueDescription": "Issuer Re-presentment Unworked"
  },
  {
    "queueName": "AcquirerFirstCBUnworked",
    "queueDescription": "Acquirer First CB Unworked"
  },
  {
    "queueName": "FeeCollectionUnworked",
    "queueDescription": "Fee Collection Unworked"
  },
  {
    "queueName": "IssuerWorked",
    "queueDescription": "Issuer Worked"
  },
  {
    "queueName": "AcquirerWorked",
    "queueDescription": "Acquirer Worked"
  },
  {
    "queueName": "Pending",
    "queueDescription": "Pending"
  },
  {
    "queueName": "SenderCaseFiling",
    "queueDescription": "Sender Case Filing"
  },
  {
    "queueName": "ReceiverCaseFiling",
    "queueDescription": "Receiver Case Filing"
  },
  {
    "queueName": "Closed",
    "queueDescription": "Closed"
  },
  {
    "queueName": "PendingDocumentation",
    "queueDescription": "Pending Documentation"
  },
  {
    "queueName": "AcquirerCollaborationUnworked",
    "queueDescription": "Acquirer Collaboration Unworked"
  },
  {
    "queueName": "IssuerCollaborationUnworked",
    "queueDescription": "Issuer Collaboration Unworked"
  }
]
```

### Retrieve Claims from Queue {#retrieve-claims-from-queue}

Before Retrieve Claims from Queue, [Retrieve Queue Names](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-queue-names) can be used to retrieve a queue-name.

|          API Call          |                     Description                      |      URI       |   Response   |
|----------------------------|------------------------------------------------------|----------------|--------------|
| Retrieve claims from queue | This resource retrieves claims within a given queue. | GET /v6/queues | HTTP: 200 OK |

No body

### Retrieve Claims from Queue within Date Range {#retrieve-claims-from-queue-within-date-range}

|                   API Call                   |                                         Description                                         |       URI       |   Response   |
|----------------------------------------------|---------------------------------------------------------------------------------------------|-----------------|--------------|
| Retrieve claims from queue within date range | Allows the retrieval of claims in a queue within the Last Modified Date range of the claim. | POST /v6/queues | HTTP: 200 OK |

* Json

```json
{
  "queueName": "Rejects",
  "lastModifiedDateFrom": "2026-06-22T12:01",
  "lastModifiedDateTo": "2026-06-23T12:01",
  "pageNb": "1"
}
```

## 5. Case Filing {#5-case-filing}

### Create Case {#create-case}

|  API Call   |                     Description                      |      URI       |   Response   |
|-------------|------------------------------------------------------|----------------|--------------|
| Create case | This resource is used to generate a new Case Filing. | POST /v6/cases | HTTP: 200 OK |

* Json

```json
{
  "caseType": "1",
  "chargebackRefNum": [
    "1111423456"
  ],
  "customerFilingNumber": "5482",
  "disputeAmount": "200.00",
  "currencyCode": "USD",
  "dueDate": "2021-02-20",
  "filedAgainstIca": "004321",
  "filingAs": "A",
  "filingIca": "001234",
  "memo": "This is a test memo",
  "messageText": "This is a test message",
  "changeReasonCodeFlag": "Y",
  "updatedChargebackReasonCode": "4863",
  "changeReasonCodeReason": "This is a test reason",
  "primaryAccountNum": "5123123412341234",
  "acquirerRefNum": "05131054165000000048149",
  "chargebackReasonCode": "4863",
  "merchantName": "test name",
  "violationCode": "D.2",
  "violationDate": "2021-01-15",
  "chargebackDate": "2021-02-15",
  "creditDate": "2021-02-15"
}
```

* Json

```json
{
  "caseId": "5415322"
}
```

### Retrieve Case Documentation {#retrieve-case-documentation}

Before Retrieve Case Documentation, [Create Case](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-case) can be used to create a new case-id.

|          API Call           |                             Description                             |                URI                |   Response   |
|-----------------------------|---------------------------------------------------------------------|-----------------------------------|--------------|
| Retrieve case documentation | This resource retrieves all documentation for a Case Filing record. | GET /v6/cases/{case-id}/documents | HTTP: 200 OK |

GET /mastercom/v6/cases/536092/documents?format=ORIGINAL

No body
* Json

```json
{
  "fileAttachment": {
    "filename": "CS_536092.zip",
    "file": "{base64 String}"
  }
}
```

#### Update Case {#update-case}

Before Update Case, [Create Case](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-case) can be used to create a new case-id.

|  API Call   |                 Description                 |           URI           |   Response   |
|-------------|---------------------------------------------|-------------------------|--------------|
| Update case | This resource updates a Case Filing record. | PUT /v6/cases/{case-id} | HTTP: 200 OK |

PUT /mastercom/v6/cases/536092
* Json

```json
{
  "action": "ACCEPT",
  "memo": "This is a test memo",
  "rebuttedAs": "SND"
}
```

* Json

```json
{
  "caseId": "536092"
}
```

#### Retrieve Case Status {#retrieve-case-status}

|       API Call       |                           Description                           |         URI          |   Response   |
|----------------------|-----------------------------------------------------------------|----------------------|--------------|
| Retrieve case status | This resource retrieves the processing status of a case filing. | PUT /v6/cases/status | HTTP: 200 OK |

* Json

```json
{
  "caseFilingList": [
    {
      "caseId": "536092"
    }
  ]
}
```

* Json

```json
{
  "caseFilingResponseList": [
    {
      "caseId": "536092",
      "status": "New_RECEIVER_06/18/2026 04:10:15 PM_REBUT"
    }
  ]
}
```

#### Retrieve Case Image Status {#retrieve-case-image-status}

|          API Call          |                                                                                                  Description                                                                                                   |           URI            |   Response   |
|----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------|--------------|
| Retrieve case image status | This resource retrieves the processing status of a case filing image. Resource returns a list of case id and status based upon passed in status and optional time frame. Defaults to 30 days if no time frame. | PUT/v6/cases/imagestatus | HTTP: 200 OK |

* Json

```json
{
  "status": "COMPLETED",
  "startDate": "2026-06-11",
  "endDate": "2026-06-20"
}
```

* Json

```json
{
  "caseFilingImageStatusList": [
    {
      "caseId": "5415317",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415288",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415240",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415678",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415181",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415455",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415762",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415240",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415100",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415834",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415984",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415554",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415123",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415983",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415609",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415384",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415299",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415532",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415203",
      "status": "COMPLETED"
    },
    {
      "caseId": "5415673",
      "status": "COMPLETED"
    }
  ]
}
```

#### Retrieve Claim from Case {#retrieve-claim-from-case}

|         API Call         |                                 Description                                  |              URI              |   Response   |
|--------------------------|------------------------------------------------------------------------------|-------------------------------|--------------|
| Retrieve claim from case | This resource is used to retrieve the claim associated with a given case ID. | PUT /v6/cases/retrieve/claims | HTTP: 200 OK |

* Json

```json
{
  "caseFilingList": [
    {
      "caseId": "536092",
      "isIssuer": true
    }
  ]
}
```

* Json

```json
{
  "caseFilingResponseList": [
    {
      "caseId": "536092",
      "claimId": "200002025054"
    }
  ]
}
```

## 6. Fraud {#6-fraud}

### Create Fraud Item {#create-fraud-item}

Before Create Fraud, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|     API Call      |                         Description                          |                     URI                     |   Response   |
|-------------------|--------------------------------------------------------------|---------------------------------------------|--------------|
| Create fraud item | This resource is used to create a fraud item for Mastercard. | POST /v6/claims/{claim-id}/fraud/mastercard | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/fraud/mastercard
* Json

```json
{
  "acctStatus": "ACCT_IS_OPEN",
  "chgbkIndicator": "1",
  "cvcInvalidIndicator": "Y",
  "deviceType": "1",
  "fraudType": "00",
  "reportDate": "2026-02-11",
  "subType": "K"
}
```

* Json

```json
{
  "fraudId": "300000021337"
}
```

#### Get Possible Values for Fraud Item {#get-possible-values-for-fraud-item}

Before Get Possible Values for Fraud, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|              API Call              |                                         Description                                         |                       URI                        |   Response   |
|------------------------------------|---------------------------------------------------------------------------------------------|--------------------------------------------------|--------------|
| Get possible values for fraud item | This resource retrieves a structure containing possible values used to create a fraud item. | GET /v6/claims/{claim-id}/fraud/loaddataforfraud | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654/fraud/loaddataforfraud
* Json

```json
{
  "acctDeviceTypes": [
    {
      "name": "1",
      "value": "1 - Chip with PIN"
    },
    {
      "name": "2",
      "value": "2 - Chip without PIN"
    },
    {
      "name": "3",
      "value": "3 - Magnetic stripe"
    },
    {
      "name": "4",
      "value": "4 - PayPass"
    },
    {
      "name": "A",
      "value": "A - Chip with PIN and Magnetic Stripe"
    },
    {
      "name": "B",
      "value": "B - Chip with PIN and PayPass"
    },
    {
      "name": "C",
      "value": "C - Chip with PIN, Magnetic Stripe, and PayPass"
    },
    {
      "name": "D",
      "value": "D - Chip without PIN and Magnetic Stripe"
    },
    {
      "name": "E",
      "value": "E - Chip without PIN and PayPass"
    },
    {
      "name": "F",
      "value": "F - Chip without PIN, Magnetic Stripe, and PayPass"
    },
    {
      "name": "G",
      "value": "G - Mag Stripe only with PIN"
    },
    {
      "name": "H",
      "value": "H - Mag Stripe and Paypass only"
    },
    {
      "name": "I",
      "value": "I - Chip without PIN and without Mage Stripe"
    },
    {
      "name": "J",
      "value": "J - Internet Card"
    }
  ],
  "acctStatuses": [
    {
      "name": " ",
      "value": "  - Data not provided"
    },
    {
      "name": "N",
      "value": "N - Account has not been closed"
    },
    {
      "name": "Y",
      "value": "Y - Account has been closed"
    }
  ],
  "cardValidCodes": [
    {
      "name": "*",
      "value": "* - CVC-1 code either valid or not provided"
    },
    {
      "name": "?",
      "value": "? - Response Code Unknown"
    },
    {
      "name": "E",
      "value": "E - CVC 3 unpredictable number not valid length"
    },
    {
      "name": "M",
      "value": "M - CVC 2 Valid"
    },
    {
      "name": "N",
      "value": "N - Invalid (Non-match)"
    },
    {
      "name": "P",
      "value": "P - Unable to Process"
    },
    {
      "name": "U",
      "value": "U - Issuer Unregistered to Process"
    },
    {
      "name": "Y",
      "value": "Y - CVC-1 Code not valid"
    }
  ],
  "subTypes": [
    {
      "name": "A",
      "value": "A - Advance Fee Scam"
    },
    {
      "name": "H",
      "value": "H - Purchase Scam"
    },
    {
      "name": "I",
      "value": "I - Impersonation Scam"
    },
    {
      "name": "K",
      "value": "K - Fraud occurred on a convenience check or balance transfer"
    },
    {
      "name": "N",
      "value": "N - PIN not used"
    },
    {
      "name": "P",
      "value": "P - PIN used"
    },
    {
      "name": "R",
      "value": "R - Romance Scam"
    },
    {
      "name": "U",
      "value": "U - Unavailable"
    },
    {
      "name": "V",
      "value": "V - Value"
    }
  ]
}
```

## 7. Retrievals {#7-retrievals}

### Create Retrieval Request {#create-retrieval-request}

Before Create Retrieval Request, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|         API Call         |                  Description                   |                     URI                      |   Response   |
|--------------------------|------------------------------------------------|----------------------------------------------|--------------|
| Create retrieval request | This resource creates a new retrieval request. | POST /v6/claims/{claim-id}/retrievalrequests | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/retrievalrequests
* Json

```json
{
  "retrievalRequestReason": "6343",
  "docNeeded": "2",
  "instructionsForHealthcare": "Instructions to acquirer for fulfilling the retrieval request"
}
```

* Json

```json
{
  "requestId": "300292563061"
}
```

### Acquirer Fulfill a Request {#acquirer-fulfill-a-request}

Before Acquirer Fulfill Request, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.  

[Create Retrieval Request](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-retrieval-request) can be used to create a new request-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) can be used to retrieve an existing request-id associated with a claim.

|          API Call          |                            Description                             |                                  URI                                   |   Response   |
|----------------------------|--------------------------------------------------------------------|------------------------------------------------------------------------|--------------|
| Acquirer fulfill a request | This resource is used by Acquirers to fulfill a retrieval request. | POST /v6/claims/{claim-id}/retrievalrequests/{request-id}/fulfillments | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/retrievalrequests/300002296235/fulfillments
* Json

```json
{
  "acquirerResponseCd": "B",
  "refundReversalType": "REFUND",
  "refundReversalDate": "2026-06-15T12:01",
  "refundReversalReferenceId": "123458111",
  "memo": "This is a test memo"
}
```

* Json

```json
{
  "requestId": "300002296235"
}
```

### Issuer Respond to Fulfillment {#issuer-respond-to-fulfillment}

Before Issuer Respond to Fulfillment Request, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Create Retrieval Request](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-retrieval-request) can be used to create a new request-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) can be used to retrieve an existing request-id associated with a claim.

|           API Call            |                          Description                          |                                       URI                                        |   Response   |
|-------------------------------|---------------------------------------------------------------|----------------------------------------------------------------------------------|--------------|
| Issuer respond to fulfillment | This resource is used by Issuers to respond to a fulfillment. | POST /v6/claims/{claim-id}/retrievalrequests/{request-id}/fulfillments/ response | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/retrievalrequests/300002296235/fulfillments/response
* Json

```json
{
  "issuerResponseCd": "APPROVE",
  "memo": "This is a test memo"
}
```

* Json

```json
{
  "requestId": "300002296235"
}
```

### Get Possible Value Lists for Create {#get-possible-value-lists-for-create}

Before Get Possible Values for Retrieval, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|              API Call               |                                            Description                                             |                                   URI                                   |   Response   |
|-------------------------------------|----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|--------------|
| Get possible value lists for create | This resource retrieves a structure containing possible values used to create a retrieval request. | GET /v6/claims/{claim-id}/retrievalrequest/loaddataforretrievalrequests | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654/retrievalrequests/loaddataforretrievalrequests

No body
* Json

```json
{
  "reasonCodes": [
    {
      "name": "6305",
      "value": "6305 - Cardholder does not agree with amount billed"
    },
    {
      "name": "6321",
      "value": "6321 - Cardholder does not recognize transaction"
    },
    {
      "name": "6322",
      "value": "6322 - Request Transaction Certificate for a chip transaction"
    },
    {
      "name": "6323",
      "value": "6323 - Cardholder needs information for personal records"
    },
    {
      "name": "6341",
      "value": "6341 - Fraud investigation"
    },
    {
      "name": "6342",
      "value": "6342 - Potential chargeback or compliance documentation is required"
    },
    {
      "name": "6343",
      "value": "6343 - Real-time Substantiation Audit Request"
    },
    {
      "name": "6390",
      "value": "6390 - Identifies a syntax error return"
    }
  ],
  "docNeeded": [
    {
      "name": "1",
      "value": "1 - Hard copy original document."
    },
    {
      "name": "2",
      "value": "2 - Copy or image (photocopy, microfilm, fax) of original document."
    },
    {
      "name": "4",
      "value": "4 - Substitute draft."
    }
  ]
}
```

### Get documentation {#get-documentation}

Before Get Retrieval Doc, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.  

[Create Retrieval Request](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-retrieval-request) can be used to create a new request-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) can be used to retrieve an existing request-id associated with a claim.

|     API Call      |                             Description                             |                                URI                                 |   Response   |
|-------------------|---------------------------------------------------------------------|--------------------------------------------------------------------|--------------|
| Get Documentation | This resource retrievals all documentation for a retrieval request. | GET /v6/claims/{claim-id}/retrievalrequests/{request-id}/documents | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654/retrievalrequests/300002296235/documents?format=ORIGINAL
* Json

```json
{
  "fileAttachment": {
    "filename": "RT_300002296235.zip",
    "file": "{base 64 string}"
  }
}
```

### Retrieval Fulfillment Status {#retrieval-fulfillment-status}

|           API Call           |                           Description                           |               URI                |   Response   |
|------------------------------|-----------------------------------------------------------------|----------------------------------|--------------|
| Retrieval Fulfillment Status | This resource retrieves the processing status of a fulfillment. | PUT /v6/retrievalrequests/status | HTTP: 200 OK |

* Json

```json
{
  "retrievalList": [
    {
      "claimId": "200002020654",
      "requestId": "300002296235"
    }
  ]
}
```

* Json

```json
{
  "retrievalResponseList": [
    {
      "claimId": "200002020654",
      "requestId": "300002296235",
      "status": "COMPLETED"
    }
  ]
}
```

## 8. Reconciliation {#8-reconciliation}

### Create reconciliation report {#create-reconciliation-report}

|           API Call           |                                       Description                                        |                URI                |   Response   |
|------------------------------|------------------------------------------------------------------------------------------|-----------------------------------|--------------|
| Create reconciliation report | This resource acknowledges the request and returns a UUID for the reconciliation report. | POST /v6/reconreport/data/request | HTTP: 200 OK |

* Json

```json
{
  "ica": [
    "000001",
    "000002"
  ],
  "startDate": "2026-06-15",
  "endDate": "2026-06-16",
  "cycles": [
    1
  ],
  "enhancedReconciliationReportFlag": false
}
```

* Json

```json
{
  "reportIdentifier": "eaed2030-15a2-496e-a27f-0f2fca84e3c0"
}
```

### Reconciliation Report {#reconciliation-report}

Before Retrieve Reconciliation Report, [Create reconciliation](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-reconciliation-report) can be used to create a new request-id   
[Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) can be used to generate a new reportIdentifier.

|       API Call        |                                   Description                                    |                          URI                           |   Response   |
|-----------------------|----------------------------------------------------------------------------------|--------------------------------------------------------|--------------|
| Reconciliation Report | This resource returns a reconciliation report stored in a base64 encoded string. | POST /v6/reconreport/data/retrieval/{reportIdentifier} | HTTP: 200 OK |

POST /mastercom/v6/reconreport/data/retrieval/123e4567-e89b-42d3-a456-556642440000

No body
* Json

```json
{
  "status": "Available",
  "data": "RmlsZSBJRCxNZXNzYWdlIE51bWJlcixDbGFpbSBJRCxFdmVudCBJRCxDYXJkIElzc3VlciBSZWZlcmVuY2UgRGF0YSxBY3F1aXJlciBSZWZlcmVuY2UgTnVtYmVyLE1USSxQcmltYXJ5IEFjY291bnQgTnVtYmVyLFByb2Nlc3NpbmcgQ29kZSxGdW5jdGlvbiBDb2RlLE1lc3NhZ2UgUmVhc29uIENvZGUsQW1vdW50IFRyYW5zYWN0aW9uLFRyYW5zYWN0aW9uIEN1cnJlbmN5IENvZGUsVHJhbnNhY3Rpb24gQ3VycmVuY3kgRXhwb25lbnQsQW1vdW50IFNlbmRlcidzIERFIDA1IHdpdGhvdXQgZmVlcyxSZWNvbmNpbGlhdGlvbiBDdXJyZW5jeSBDb2RlLFJlY29uY2lsaWF0aW9uIEN1cnJlbmN5IEV4cG9uZW50LEFtb3VudCBDYXJkaG9sZGVyIEJpbGxpbmcsQ2FyZGhvbGRlciBCaWxsaW5nIEN1cnJlbmN5IENvZGUsQ2FyZGhvbGRlciBCaWxsaW5nIEN1cnJlbmN5IEV4cG9uZW50LFJldHJpZXZhbCBSZWZlcmVuY2UgTnVtYmVyLENhcmQgQWNjZXB0b3IgQnVzaW5lc3MgQ29kZSxDYXJkIEFjY2VwdG9yIElELENhcmQgQWNjZXB0b3IgTmFtZSxEYXRlICYgVGltZSBvZiBUcmFuc2FjdGlvbixUcmFuc2FjdGlvbiBPcmlnaW5hdG9yIEluc3RpdHV0aW9uIElEIENvZGUsVHJhbnNhY3Rpb24gRGVzdGluYXRpb24gSW5zdGl0dXRpb24gSUQgQ29kZSxSZXZlcnNhbCBGbGFnLENvbnZlcnNpb24gUmF0ZSBSZWNvbmNpbGlhdGlvbixBbW91bnRzIE9yaWdpbmFsLE9yaWdpbmFsIEFtb3VudCBDdXJyZW5jeSBDb2RlLE9yaWdpbmFsIEFtb3VudCBDdXJyZW5jeSBFeHBvbmVudCxBbW91bnQgVHJhbnNhY3Rpb24gRmVlLENsZWFyaW5nIERhdGUsQ2xlYXJpbmcgQ3ljbGUgSUQsVHJhbnNhY3Rpb24gU3RhdHVzLEFtb3VudCBSZWNvbmNpbGlhdGlvbiB3aXRoIGZlZXMsUmVjb25jaWxpYXRpb24gQ3VycmVuY3kgQ29kZSxSZWNvbmNpbGlhdGlvbiBDdXJyZW5jeSBFeHBvbmVudCxSZWFzb24gZm9yIFJlamVjdGlvbixUcmFuc2FjdGlvbiBMaWZlIEN5Y2xlIElELEN1cnJlbmN5IENvbnZlcnNpb24gQXNzZXNzbWVudCBBbW91bnQsQ3VycmVuY3kgQ29udmVyc2lvbiBBc3Nlc3NtZW50IEN1cnJlbmN5IENvZGUsQ3VycmVuY3kgQ29udmVyc2lvbiBBc3Nlc3NtZW50IEN1cnJlbmN5IEV4cG9uZW50Cjk5OTk5OTk5OTk5OTk5OTk5OTk5OTk5OTIsMiwyMjIyMjIyMjIyMjIsMzMzMzMzMzMzMzMyLDk5OTk5OTk5OTIsOTI5OTk5OTk5OTk5OTk5OTk5OTk5OTIsMTI0MCw1MTk5OTk5OTk5OTk5OTkxMTEyLDAwMDAwMCwyODIsMjAxMSw5OTk5LDg0MCwyLDk5OTksODQwLDIsOTk5OSw4NDAsMiwsMCxDOTk5OTk5OTksTUVSQ0hBTlQgTkFNRSwyMDA4MzEwMDAwMDAsOTk5OTk5LDA5OTk5OSwsMTAwMDAwMDAsOTk5OSw4NDAsMiwsMjEwMTAxLDEsU1VDQ0VTUyw5OTk5LDg0MCwyLCwsMCwsCjk5OTk5OTk5OTk5OTk5OTk5OTk5OTk5OTQsNCwyMjIyMjIyMjIyMjQsMzMzMzMzMzMzMzM0LDk5OTk5OTk5OTQsOTI5OTk5OTk5OTk5OTk5OTk5OTk5OTQsMTQ0Miw1MTk5OTk5OTk5OTk5OTkxMTE0LDAwMDAwMCw0NTAsNDgxMiw5OTk5LDg0MCwyLDk5OTksODQwLDIsOTk5OSw4NDAsMiwsMCxDOTk5OTk5OTksTUVSQ0hBTlQgTkFNRSwyMDA4MzEwMDAwMDAsOTk5OTk5LDA5OTk5OSwsMTAwMDAwMDAsOTk5OSw4NDAsMiwsMjEwMTAxLDEsU1VDQ0VTUyw5OTk5LDg0MCwyLCwsMCwsCjk5OTk5OTk5OTk5OTk5OTk5OTk5OTk5OTEsMSwyMjIyMjIyMjIyMjEsMzMzMzMzMzMzMzMxLDk5OTk5OTk5OTEsOTI5OTk5OTk5OTk5OTk5OTk5OTk5OTEsMTI0MCw1MTk5OTk5OTk5OTk5OTkxMTExLDAwMDAwMCwyODIsMjAxMSw5OTk5LDg0MCwyLDk5OTksODQwLDIsOTk5OSw4NDAsMiwsMCxDOTk5OTk5OTksTUVSQ0hBTlQgTkFNRSwyMDA4MzEwMDAwMDAsOTk5OTk5LDA5OTk5OSwsMTAwMDAwMDAsOTk5OSw4NDAsMiwsMjEwMTAxLDEsU1VDQ0VTUyw5OTk5LDg0MCwyLCwsMCwsCjk5OTk5OTk5OTk5OTk5OTk5OTk5OTk5OTMsMywyMjIyMjIyMjIyMjMsMzMzMzMzMzMzMzMzLDk5OTk5OTk5OTMsOTI5OTk5OTk5OTk5OTk5OTk5OTk5OTMsMTQ0Miw1MTk5OTk5OTk5OTk5OTkxMTEzLDAwMDAwMCw0NTAsNDgzNCw5OTk5LDg0MCwyLDk5OTksODQwLDIsOTk5OSw4NDAsMiwsMCxDOTk5OTk5OTksTUVSQ0hBTlQgTkFNRSwyMDA4MzEwMDAwMDAsOTk5OTk5LDA5OTk5OSwsMTAwMDAwMDAsOTk5OSw4NDAsMiwsMjEwMTAxLDEsU1VDQ0VTUyw5OTk5LDg0MCwyLCwsMCwsCjk5OTk5OTk5OTk5OTk5OTk5OTk5OTk5OTUsNSwyMjIyMjIyMjIyMjUsMzMzMzMzMzMzMzM1LDk5OTk5OTk5OTUsOTI5OTk5OTk5OTk5OTk5OTk5OTk5OTUsMTQ0Miw1MTk5OTk5OTk5OTk5OTkxMTE1LDAwMDAwMCw0NTAsNDgwNyw5OTk5LDg0MCwyLDk5OTksODQwLDIsOTk5OSw4NDAsMiwsMCxDOTk5OTk5OTksTUVSQ0hBTlQgTkFNRSwyMDA4MzEwMDAwMDAsOTk5OTk5LDA5OTk5OSwsMTAwMDAwMDAsOTk5OSw4NDAsMiwsMjEwMTAxLDEsU1VDQ0VTUyw5OTk5LDg0MCwyLCwsMCwsCg=="
}
```

## 9. Chargebacks (Debit Mastercard and Europe Dual Acquirer) {#9-chargebacks-debit-mastercard-and-europe-dual-acquirer}

### Create Debit MC Chargeback {#create-debit-mc-chargeback}

Before Create Debit MC Chargeback, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|          API Call          |                                              Description                                               |                      URI                       |   Response   |
|----------------------------|--------------------------------------------------------------------------------------------------------|------------------------------------------------|--------------|
| Create Debit MC chargeback | This resource creates a new Debit MC message chargeback for Debit Mastercard and Europe Dual Acquirer. | POST /v6/claims/{claim-id}/chargebacks/debitmc | HTTP: 200 OK |

POST /claims/200002020654/chargebacks/debitmc
* Json

```json
{
  "brand": "MD",
  "replacementAmount": "100.00",
  "reversalReasonCode": "71",
  "usageCode": "1",
  "acquirerFirstReferenceNumber": "05103246259000000000126",
  "additionalInformation": "SMTM Manual",
  "adjustmentContactFax": "5555555555",
  "adjustmentContactName": "John Smith",
  "adjustmentContactPhone": "5555555555",
  "controlNumber": "99999",
  "dataRecordText": "R3",
  "documentIndicator": "1",
  "documentType": "1",
  "illegibleItemCd": "1",
  "program": "INVAL",
  "retrievalRequestDate": "010129",
  "securityBulletinNumber": "122",
  "refundNotReceivedIndicator": "true",
  "fileAttachment": {
    "filename": "testimage111.tif",
    "file": "This is an image file stored in a base64 encoded string"
  }
}
```

* Json

```json
{
  "chargebackId": "300003030250"
}
```

### Create Debit MC chargeback Reversal {#create-debit-mc-chargeback-reversal}

Before Create Debit MC Chargeback Reversal, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Create Debit MC Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-debit-mc-chargeback) can be used to create a new chargeback-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) to retrieve an existing chargeback-id associated with a claim.

|              API Call               |                                        Description                                         |                                   URI                                   |   Response   |
|-------------------------------------|--------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|--------------|
| Create Debit MC chargeback reversal | This resource creates a chargeback reversal for Debit Mastercard and Europe Dual Acquirer. | POST /v6/claims/{claim-id}/chargebacks/debitmc/{chargeback-id}/reversal | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/chargebacks/debitmc/300018439680/reversal
* Json

```json
{
  "replacementAmount": "100.00",
  "reversalReasonCode": "82",
  "controlNumber": "99999"
}
```

* Json

```json
{
  "chargebackId": "300003030510"
}
```

### Update Debit MC Chargeback {#update-debit-mc-chargeback}

Before Update Debit MC Chargeback, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Create Debit MC Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-debit-mc-chargeback) can be used to create a new chargeback-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) to retrieve an existing chargeback-id associated with a claim.

|          API Call          |                                    Description                                    |                              URI                              |   Response   |
|----------------------------|-----------------------------------------------------------------------------------|---------------------------------------------------------------|--------------|
| Update Debit MC chargeback | This resource updates a chargeback for Debit Mastercard and Europe Dual Acquirer. | PUT /v6/claims/{claim-id}/chargebacks/debitmc/{chargeback-id} | HTTP: 200 OK |

PUT /mastercom/v6/claims/200002020654/chargebacks/debitmc/300018439680
* Json

```json
{
"memo": "This is a test memo",
"fileAttachment": {
"filename": "testimage111111.tif",
"file": "This is an image file stored in a base64 encoded string"
}
}
```

* Json

```json
{
"chargebackId": "300018439680"
}
```

### Retrieve Debit MC Chargeback Documentation {#retrieve-debit-mc-chargeback-documentation}

Before Retrieve Debit MC Chargeback Doc, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Create Debit MC Chargeback](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-debit-mc-chargeback) can be used to create a new chargeback-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) to retrieve an existing chargeback-id associated with a claim.

|                  API Call                  |                                              Description                                              |                                   URI                                   |   Response   |
|--------------------------------------------|-------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|--------------|
| Retrieve Debit MC chargeback documentation | This resource retrieves documentation for a chargeback for Debit Mastercard and Europe Dual Acquirer. | GET /v6/claims/{claim-id}/chargebacks/debitmc/{chargeback-id}/documents | HTTP: 200 OK |

GET /mastercom/v6/claims/200002020654/chargebacks/debitmc/300018439680/documents?format=ORIGINAL\&Format=JSON

No body
* Json

```json
{
"fileAttachment": {
"filename": "CB_300018439680.zip",
"file": "{base 64 string}"
}
}
```

### Acknowledge Received Debit MC Chargebacks {#acknowledge-received-debit-mc-chargebacks}

|                 API Call                  |                                              Description                                              |                   URI                   |   Response   |
|-------------------------------------------|-------------------------------------------------------------------------------------------------------|-----------------------------------------|--------------|
| Acknowledge received Debit MC chargebacks | This resource marks a received chargeback as processed for Debit Mastercard and Europe Dual Acquirer. | PUT /v6/chargebacks/debitmc/acknowledge | HTTP: 200 OK |

* Json

```json
{
"chargebackList": [
{
"claimId": "200002020654",
"chargebackId": "300018439680"
}
]
}
```

* Json

```json
{
"chargebackResponseList": [
{
"chargebackId": "300014887392",
"status": "PROCESSED",
"failureReason": null
}
]
}
```

### Retrieve Debit MC Chargeback Status {#retrieve-debit-mc-chargeback-status}

|              API Call               |                                                    Description                                                     |                URI                 |   Response   |
|-------------------------------------|--------------------------------------------------------------------------------------------------------------------|------------------------------------|--------------|
| Retrieve Debit MC chargeback status | This resource retrieves the processing status of a chargeback image for Debit Mastercard and Europe Dual Acquirer. | PUT /v6/chargebacks/debitmc/status | HTTP: 200 OK |

* Json

```json
{
"chargebackList": [
{
"claimId": "200002020654",
"chargebackId": "300018439680"
}
]
}
```

* Json

```json
{
"chargebackResponseList": [
{
"claimId": "200002020654",
"chargebackId": "300018439680",
"status": "RELEASED"
}
]
}
```

## 10. Retrievals (Debit Mastercard and Europe Dual Acquirer) {#10-retrievals-debit-mastercard-and-europe-dual-acquirer}

### Create Debit MC Retrieval Request {#create-debit-mc-retrieval-request}

Before Create Retrieval Request, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|             API Call              |                                         Description                                          |                         URI                          |   Response   |
|-----------------------------------|----------------------------------------------------------------------------------------------|------------------------------------------------------|--------------|
| Create debit mc retrieval request | This resource creates a new retrieval request for Debit Mastercard and Europe Dual Acquirer. | POST /v6/claims/{claim-id}/retrievalrequests/debitmc | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/retrievalrequests/debitmc
* Json

```json
{
  "documentType": "1",
  "replacementAmount": "200.00",
  "reversalReasonCode": "43",
  "usageCode": "6",
  "additionalInformation": "SMTM Manual",
  "controlNumber": "12354"
}
```

* Json

```json
{
  "requestId": "300891021932"
}
```

### Issuer Respond to Fulfillment {#issuer-respond-to-fulfillment-1}

Before Issuer Respond to Fulfillment Request, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Create Debit MC Retrieval Request](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-debit-mc-retrieval-request) can be used to create a new request-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) can be used to retrieve an existing request-id associated with a claim.

|           API Call            |                                                 Description                                                 |                                           URI                                           |   Response   |
|-------------------------------|-------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|--------------|
| Issuer respond to fulfillment | This resource is used by Issuers to respond to a fulfillment for Debit Mastercard and Europe Dual Acquirer. | POST /v6/claims/{claim-id}/retrievalrequests/debitmc/{request-id}/fulfillments/response | HTTP: 200 OK |

* Json

```json
{
"issuerResponseCd": "APPROVE",
"memo": "This is a test memo"
}
```

* Json

```json
{
"requestId": "300002296235"
}
```

### Get documentation {#get-documentation-1}

Before Get Retrieval Doc, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Create Debit MC Retrieval Request](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-debit-mc-retrieval-request) can be used to create a new request-id, or [Retrieve Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claim) can be used to retrieve an existing request-id associated with a claim.

|     API Call      |                                                   Description                                                    |                                    URI                                     |   Response   |
|-------------------|------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------|--------------|
| Get Documentation | This resource retrieves all documentation for a retrieval request for Debit Mastercard and Europe Dual Acquirer. | GET /v6/claims/{claim-id}/retrievalrequests/debitmc/{request-id}/documents | HTTP: 200 OK |

No body
* Json

```json
{
"fileAttachment": {
"filename": "RT_300002296235.zip",
"file": "{base 64 string}"
}
}
```

### Retrieval Fulfillment Status {#retrieval-fulfillment-status-1}

|           API Call           |                                                     Description                                                     |                   URI                    |   Response   |
|------------------------------|---------------------------------------------------------------------------------------------------------------------|------------------------------------------|--------------|
| Retrieval Fulfillment Status | This resource retrieves the processing status of a fulfillment image for Debit Mastercard and Europe Dual Acquirer. | PUT /v6/retrievalrequests/debitmc/status | HTTP: 200 OK |

* Json

```json
{
"retrievalList": [
{
"claimId": "200002020654",
"requestId": "300002296235"
}
]
}
```

* Json

```json
{
"retrievalResponseList": [
{
"claimId": "200002020654",
"requestId": "300002296235",
"status": "COMPLETED"
}
]
}
```

## 11. Transactions (Debit Mastercard and Europe Dual Acquirer) {#11-transactions-debit-mastercard-and-europe-dual-acquirer}

### Transaction Search Debit MC {#transaction-search-debit-mc}

|          API Call           |                                                     Description                                                     |                 URI                  |   Response   |
|-----------------------------|---------------------------------------------------------------------------------------------------------------------|--------------------------------------|--------------|
| Debit MC transaction search | This resource is used to query for Debit MC message transaction data for Debit Mastercard and Europe Dual Acquirer. | POST /v6/transactions/debitmc/search | HTTP: 200 OK |

* Json

```json
{
  "primaryAccountNumber": "5488888888887192",
  "settlementFromDate": "2026-06-22",
  "settlementToDate": "2026-06-22",
  "acquirerRefNumber": "05436847276000293995738",
  "switchSerialNumber": "142389095"
}
```

* Json

```json
{
  "transactionSummaryList": [
    {
      "authTransactionId": "LLAh8uX0koZ_lLlkWc9c7uzk7pNWb4dZolGKNbyJ8I4lq6Qnt0UXU0pZ0aFIexamow9+BSTTWw6P3T96Ndcnc==",
      "clearingTransactionId": "jnI9Q2DhS5Ta-m4zV6sgL7YLh_ijpgJjGb3zdn_JGtUI49GI8Ro_Qyzayn4CHZJZPllweqhFeub0_JtEtJBPJ==",
      "singleMessageSummaryDetails": {
        "authTransaction": {
          "acquirerReferenceNumber": "05436847276000293995738",
          "adviceReasonCode": "3462805",
          "brand": "MD",
          "localCurrencyCode": "036",
          "localRequestedAmount": "976.50",
          "merchantName": "The Kroger Co.",
          "merchantType": "6011",
          "primaryAccountNumber": "5488888888887192",
          "processingCode": "928964",
          "responseCode": "49",
          "responseSource": "M",
          "settlementDate": "062226",
          "switchSerialNumber": "142389095",
          "switchDateTime": "062226200322",
          "trace": "999473",
          "tranType": "A"
        },
        "clearingTransaction": {
          "acquirerReferenceNumber": "05436847276000293995738",
          "adviceReasonCode": "3462805",
          "brand": "MD",
          "localCurrencyCode": "036",
          "localRequestedAmount": "976.50",
          "merchantName": "The Kroger Co.",
          "merchantType": "6011",
          "primaryAccountNumber": "5488888888887192",
          "processingCode": "928964",
          "responseCode": "49",
          "responseSource": "M",
          "settlementDate": "062226",
          "switchSerialNumber": "142389095",
          "switchDateTime": "062226200322",
          "trace": "999473",
          "tranType": "C"
        }
      }
    }
  ]
}
```

### Retrieve Debit MC Transaction Details {#retrieve-debit-mc-transaction-details}

Before Retrieve Debit MC Transaction Details, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.
[Transaction Search Debit MC](https://developer.mastercard.com/mastercom/documentation/testing/index.md#transaction-search-debit-mc) can be used to retrieve transaction-id.

|               API Call                |                                                   Description                                                    |                      URI                       |   Response   |
|---------------------------------------|------------------------------------------------------------------------------------------------------------------|------------------------------------------------|--------------|
| Retrieve Debit MC transaction details | This resource is used to retrieve details for a given transaction for Debit Mastercard and Europe Dual Acquirer. | GET /v6/{claim-id}/transactions/debitmc/detail | HTTP: 200 OK |

GET /mastercom/v6/200002020654/transactions/debitmc/detail

No body
* Json

```json
{
  "authTransaction": {
    "acqLocCntry": "ESP",
    "acquirerAddress": "MADRID",
    "acquirerAdjustmentSettlementAmount": "423.98",
    "acquirerAdjustmentSettlementAmountIndicator": "CR",
    "acquirerAdjustmentSettlementCompletionAmount": "423.98",
    "acquirerAdjustmentSettlementCurrency": "978",
    "acquirerAdviceReason": "9186182",
    "acquirerBridgedICA": "006003",
    "acquirerCity": "MADRID",
    "acquirerCurrencyConversionRate": "11138",
    "acquirerInstitutionNumber": "1900019231",
    "acquirerInterchangeAmount": "6.79",
    "acquirerInterchangeCurrency": "978",
    "acquirerName": "Acquirer name",
    "acquirerProcessorID": "9000006356",
    "acquirerReferenceNumber": "51032462590843458933173",
    "acquirerSettlementCompletionAmount": "423.98",
    "acquirerSettlementCompletionCurrency": "978",
    "acquirerSettlementConversionRate": "11138",
    "additionalAdvice": "003",
    "additionalPOSData": "17124718",
    "additionalResponse": "0153239",
    "adjustmentAdviceReason": "9338628",
    "adjustmentCashbackAmount": "423.98",
    "adjustmentDate": "260613",
    "adjustmentPurchaseAmount": "423.98",
    "afaMember": "N",
    "alternatePrimaryAccountNumber": "5123437606127948475",
    "amountICCR": "423.98",
    "atmPosFlag": "N",
    "banknetReferenceNumber": "06XOQPT0I",
    "bridgingICA": "007317",
    "businessActivity": "ACT",
    "cashBackAmount": "3.34",
    "cashBackCurrency": "978",
    "catLevel": "2",
    "cccaIssuerBankName": "Issuer bank name",
    "chipFlag": "N",
    "conditionCode": "9C0",
    "corporateCardIndicator": "N",
    "creditLineUsageFee": null,
    "crossBorderIndicator": "Y",
    "currencyConversionAssesementAmount": "7.25",
    "currencyConversionAssesementCurrency": "978",
    "currencyConversionIndicator": "Y",
    "cvc2ProgramValidationCode": "C",
    "documentIndicator": "1",
    "feesInterChgAcqLoc": "878737683",
    "financialInstitutionID": "AA",
    "fraudDate": "260618",
    "fraudDeviceType": "1",
    "fraudType": "AA",
    "gcmsAdviceCode": "9715",
    "gcmsSettlementDate": "260618",
    "issuerAdjustmentSettlementAmount": "423.98",
    "issuerAdjustmentSettlementAmountIndicator": "DR",
    "issuerAdjustmentSettlementCompletionAmount": "423.98",
    "issuerAdjustmentSettlementCurrency": "978",
    "issuerAdviceReason": "5544566",
    "issuerCurrencyConversionRate": "11138",
    "issuerICA": "003146",
    "issuerInstitutionNumber": "1900058507",
    "issuerInterchangeAmount": "423.98",
    "issuerInterchangeCurrency": "978",
    "issuerProcessorID": "9000006022",
    "issuerSettlementCompletionAmount": "8.42",
    "issuerSettlementCompletionCurrency": "978",
    "issuerSettlementConversionRate": "11138",
    "localCompletionAmount": "8.42",
    "localCurrencyCode": "978",
    "localRequestedAmount": "3.01",
    "mcElectronicIndicator": "A",
    "mcResponseValue": "AA",
    "merchantCategoryCodeInfo": "DEPARTMENT STORES",
    "merchantType": "5311",
    "originalCardHolderBillingAmount": "423.98",
    "originalCardHolderBillingCurrency": "978",
    "originalCashbackAmount": "423.98",
    "originalCashbackCurrency": "978",
    "originalPurchaseAmount": "423.98",
    "ownerID": "s018924",
    "pointOfServiceAmount": "423.98",
    "pointOfServiceCurrency": "978",
    "posData": "101001000150084048111-1609",
    "posEntry": "900",
    "primaryAccountNumber": "5123437210784500884",
    "primaryAccountNumberSequenceNumber": "0448338956463949",
    "processingCode": "431307",
    "productIdentifierCode": "MCD",
    "programIndicator": "Q",
    "qpsPayPassChargebackElgibility": "I",
    "referenceNumber": "DMC45034",
    "responseCode": "67",
    "responseSource": "S",
    "serviceCode": "637",
    "serviceLevelIndicator": "JCU",
    "settlementDate": "260618",
    "settlementDatePosition": "260618",
    "settlementServiceConfiguration": "001",
    "surchargeFreeIndicator": "N",
    "switchDateTime": "061326200439",
    "switchSerialNumber": "107653713",
    "switchSerialNumberPosition": "123842",
    "switchTime": "200439",
    "terminalID": "R3_E2 9",
    "trace": "994288",
    "transactionCategoryCode": "Z",
    "transactionClass": "MS ATM DOM",
    "transactionDateTime": "260618",
    "transitData": "LHSHE",
    "tranType": "A",
    "universalCardAuthenticationFee": "6.76",
    "usageCode": "2"
  },
  "clearingTransaction": {
    "acqLocCntry": "GBR",
    "acquirerAddress": "LONDON",
    "acquirerAdjustmentSettlementAmount": "762.83",
    "acquirerAdjustmentSettlementAmountIndicator": "CR",
    "acquirerAdjustmentSettlementCompletionAmount": "762.83",
    "acquirerAdjustmentSettlementCurrency": "826",
    "acquirerAdviceReason": "5388382",
    "acquirerBridgedICA": "002265",
    "acquirerCity": "LONDON",
    "acquirerCurrencyConversionRate": "11734",
    "acquirerInstitutionNumber": "1900081045",
    "acquirerInterchangeAmount": "6.95",
    "acquirerInterchangeCurrency": "826",
    "acquirerName": "Acquirer name",
    "acquirerProcessorID": "9000006238",
    "acquirerReferenceNumber": "51032462590959890859210",
    "acquirerSettlementCompletionAmount": "762.83",
    "acquirerSettlementCompletionCurrency": "826",
    "acquirerSettlementConversionRate": "11734",
    "additionalAdvice": "004",
    "additionalPOSData": "10075721",
    "additionalResponse": "0163375",
    "adjustmentAdviceReason": "3391172",
    "adjustmentCashbackAmount": "762.83",
    "adjustmentDate": "260613",
    "adjustmentPurchaseAmount": "762.83",
    "afaMember": "N",
    "alternatePrimaryAccountNumber": "5123437458638843763",
    "amountICCR": "762.83",
    "atmPosFlag": "Y",
    "banknetReferenceNumber": "EHOVFIPHC",
    "bridgingICA": "009345",
    "businessActivity": "ACT",
    "cashBackAmount": "3.82",
    "cashBackCurrency": "826",
    "catLevel": "7",
    "cccaIssuerBankName": "Issuer bank name",
    "chipFlag": "Y",
    "conditionCode": "9C0",
    "corporateCardIndicator": "Y",
    "creditLineUsageFee": null,
    "crossBorderIndicator": "N",
    "currencyConversionAssesementAmount": "3.93",
    "currencyConversionAssesementCurrency": "826",
    "currencyConversionIndicator": "Y",
    "cvc2ProgramValidationCode": "C",
    "documentIndicator": "0",
    "feesInterChgAcqLoc": "357870207",
    "financialInstitutionID": "AA",
    "fraudDate": "260618",
    "fraudDeviceType": "2",
    "fraudType": "AA",
    "gcmsAdviceCode": "1486",
    "gcmsSettlementDate": "260618",
    "issuerAdjustmentSettlementAmount": "762.83",
    "issuerAdjustmentSettlementAmountIndicator": "DR",
    "issuerAdjustmentSettlementCompletionAmount": "762.83",
    "issuerAdjustmentSettlementCurrency": "826",
    "issuerAdviceReason": "2926566",
    "issuerCurrencyConversionRate": "11734",
    "issuerICA": "005553",
    "issuerInstitutionNumber": "1900016508",
    "issuerInterchangeAmount": "762.83",
    "issuerInterchangeCurrency": "826",
    "issuerProcessorID": "9000007004",
    "issuerSettlementCompletionAmount": "2.52",
    "issuerSettlementCompletionCurrency": "826",
    "issuerSettlementConversionRate": "11734",
    "localCompletionAmount": "2.52",
    "localCurrencyCode": "826",
    "localRequestedAmount": "5.57",
    "mcElectronicIndicator": "A",
    "mcResponseValue": "AA",
    "merchantCategoryCodeInfo": "DUTY FREE STORES",
    "merchantType": "5309",
    "originalCardHolderBillingAmount": "762.83",
    "originalCardHolderBillingCurrency": "826",
    "originalCashbackAmount": "762.83",
    "originalCashbackCurrency": "826",
    "originalPurchaseAmount": "762.83",
    "ownerID": "s007698",
    "pointOfServiceAmount": "762.83",
    "pointOfServiceCurrency": "826",
    "posData": "101001000150084048111-5548",
    "posEntry": "901",
    "primaryAccountNumber": "5123432989723764179",
    "primaryAccountNumberSequenceNumber": "4786947247552451",
    "processingCode": "018629",
    "productIdentifierCode": "MCD",
    "programIndicator": "Q",
    "qpsPayPassChargebackElgibility": "I",
    "referenceNumber": "DMC27552",
    "responseCode": "86",
    "responseSource": "S",
    "serviceCode": "659",
    "serviceLevelIndicator": "BYL",
    "settlementDate": "260618",
    "settlementDatePosition": "260618",
    "settlementServiceConfiguration": "006",
    "surchargeFreeIndicator": "Y",
    "switchDateTime": "061326200439",
    "switchSerialNumber": "160317259",
    "switchSerialNumberPosition": "123186",
    "switchTime": "200439",
    "terminalID": "B1_W3 0",
    "trace": "990268",
    "transactionCategoryCode": "Z",
    "transactionClass": "MS ATM DOM",
    "transactionDateTime": "260618",
    "transitData": "WJLMU",
    "tranType": "C",
    "universalCardAuthenticationFee": "8.17",
    "usageCode": "3"
  }
}
```

## 12. Fees {#12-fees}

### Create Fee Collection Event {#create-fee-collection-event}

Before Create Fee Collection, [Create Claim](https://developer.mastercard.com/mastercom/documentation/testing/index.md#create-claim) can be used to create a new claim-id, or [Retrieve Claim from Queue](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue) and [Retrieve Claims from Queue Within Date Range](https://developer.mastercard.com/mastercom/documentation/testing/index.md#retrieve-claims-from-queue-within-date-range) to retrieve an existing claim-id.

|          API Call           |              Description               |              URI               |   Response   |
|-----------------------------|----------------------------------------|--------------------------------|--------------|
| Create fee collection event | This resource creates a new fee event. | POST /v6/claims/{claim-id}/fee | HTTP: 200 OK |

POST /mastercom/v6/claims/200002020654/fee
* Json

```json
{
  "cardAcceptorIdCode": "Test1234",
  "cardNumber": "510001000000134",
  "countryCode": "USA",
  "currency": "USD",
  "feeDate": "2026-06-26",
  "destinationMember": "002083",
  "feeAmount": "100.00",
  "creditSender": true,
  "creditReceiver": false,
  "mastercomControlNumber": "1589457",
  "message": "This is a test message",
  "reason": "7604",
  "settlementDate": "2026-06-26",
  "replyFeeId": "300009520876",
  "feeType": "REPLY"
}
```

* Json

```json
{
  "feeId": "30002029030"
}
```

## Negative testing {#negative-testing}

Negative testing confirms that invalid requests fail cleanly and return useful error details.

### Validate these behaviors {#validate-these-behaviors-1}

* Missing required fields return `400 Bad Request`.
* Invalid field values return validation errors with a clear `ReasonCode` and description.
* Requests for unknown resources return `404 Not Found`.

### Negative test cases {#negative-test-cases}

Use the tabs to view representative negative test cases.
POST /mastercom/v6/claims

```json
{
"disputedAmount": "100.00",
"disputedCurrency": "USD",
"claimType": "Standard"
}
```

Expected result: `400 Bad Request` because `claimId` is required.
POST /mastercom/v6/queues

```json
{
"lastModifiedDateFrom": "2026-06-22T12:01",
"lastModifiedDateTo": "2026-06-23T12:01",
"pageNb": "1"
}
```

Expected result: `400 Bad Request` because `queueName` is required.
POST /mastercom/v6/claims/200002020654/chargebacks

```json
{
"amount": "100.00",
"chargebackType": "CHARGEBACK",
"currency": "USD",
"documentIndicator": "false",
"credPostedAsPurchase": false,
"isPartialChargeback": false,
"messageText": "This is a test message text",
"settlementDate": "2026-06-26",
"localTax1IVA": "0.60",
"installmentFee": 1.2,
"editExclusionCode": "BO",
"refundNotReceivedIndicator": "true",
"includeCurrencyConversionAssessmentCCA": "true",
"acknowledgeFirstPartyTrustEvidence": "false"
}
```

Expected result: `400 Bad Request` because `reasonCode` is required.
PUT /mastercom/v6/claims/200002020654/chargebacks/300018439680

```json
{
"memo": "This is a test memo"
}
```

Expected result: `400 Bad Request` because either `fileAttachment` or `creditVoucherAction` needs to be provided.
PUT /mastercom/v6/cases/status

```json
{
"caseFilingList": [
{
 
}
]
}
```

Expected result: `400 Bad Request` because `case-id` is required.

For the complete list of response codes, reason codes, and formatting rules, see [Codes and Formats](https://developer.mastercard.com/mastercom/documentation/code-and-formats/index.md).

## Next Steps {#next-steps}

* Consult the [API Reference](https://developer.mastercard.com/mastercom/documentation/api-reference/index.md) for complete endpoint specifications, request and response schemas, and environment URLs.
* If you run into issues, visit [Support](https://developer.mastercard.com/mastercom/documentation/support/index.md) for FAQs and troubleshooting guidance.