# First-Party Trust Test Cases
source: https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md

This article provides test case data that shows the responses you can expect to receive for First-Party Trust from some example requests sent to the Consumer Clarity API.

## Test Cases {#test-cases}

These are the types of First-Party Trust test cases provided in this article:

#### Successful requests and responses {#successful-requests-and-responses}

* [TC1: Successful request with all request parameters](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc1-successful-request-with-all-request-parameters)
* [TC2: Successful request with the minimum parameters](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc2-successful-request-with-the-minimum-parameters)

#### Error scenarios {#error-scenarios}

* [TC3: ARN provided but no compelling evidence found](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc3-arn-provided-but-no-compelling-evidence-found)
* [TC4: ARN provided with no matches](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc4-arn-provided-with-no-matches)
* [TC5: Dispute ID provided with no matches](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc5-dispute-id-provided-with-no-matches)
* [TC6: Neither ARN nor Dispute ID are provided](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc6-neither-arn-nor-dispute-id-are-provided)

### Transaction Data test cases {#transaction-data-test-cases}

If you're enrolled in the Transaction Data service, then a transaction data link is returned in the response. When you select that link, you'll receive an encrypted response, similar to this example.

![Example of transaction data link encrypted response](https://static.developer.mastercard.com/content/consumer-clarity/documentation/img/encrypted-response.png)

The following test cases show examples of responses you can receive when enrolled in the Consumer Clarity Transaction Data service.

* [TC7: Successful request with required parameters](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc7-successful-request-with-required-parameters)
* [TC8: Request without transaction criteria](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc8-request-without-transaction-criteria)
* [TC9: Successful call center request with required parameters](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc9-successful-call-center-request-with-required-parameters)
* [TC10: Call center request without transaction criteria](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc10-call-center-request-without-transaction-criteria)   

The following tables show the request fields that are part of each test case and lists the values that are used in each one.

|                                                                                Test Case                                                                                | locale | cardAcceptor Name | cardAcceptor ID | cardAcceptor Location | cardAcceptor RegionCode | cardAcceptor CountryCode | merchantCategoryCode | transactionIdentifierType | transactionIdentifierValue | acquirerReferenceNumber |    transactionDateTime    | value  | currencyCode | cardFirstSix | cardLastFour | issuerAuthorizationCode | paymentType |              disputeId               | disputeIdType | requestorId | requestorName | requestorUserId |              paymentId               |     clearingDateTime     | clearingAmount:value | clearingAmount:currencyCode |
|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|-------------------|-----------------|-----------------------|-------------------------|--------------------------|----------------------|---------------------------|----------------------------|-------------------------|---------------------------|--------|--------------|--------------|--------------|-------------------------|-------------|--------------------------------------|---------------|-------------|---------------|-----------------|--------------------------------------|--------------------------|----------------------|-----------------------------|
| [TC1](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc1-successful-request-with-all-request-parameters) | en-US  | ETHOCA CHAIRS     | CardAcceptor123 | SUNNYVALE             | CA                      | USA                      | 5712                 | BANKNET_REF_NUM           | 123456                     | 20292029202920292029001 | 2021-06-18T22:11:05+05:00 | 361.56 | USD          | 123456       | 5363         | 123456                  | MC          | 52318413-bd05-4960-a745-f79e5c3d6de9 | CLAIM_ID      | 1234        | Ethoca Bank   | User6789        | 52318413-bd05-4960-a745-f79e5c3d6de9 | 2020-11-04T22:11:05.000Z | 250.0                | USD                         |
| [TC2](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc2-successful-request-with-the-minimum-parameters) | en-US  | ETHOCA CHAIRS     | CardAcceptor123 | SUNNYVALE             | CA                      | USA                      | 5712                 | null                      | null                       | null                    | null                      | null   | null         | null         | null         | null                    | null        | 52318413-bd05-4960-a745-f79e5c3d6de9 | CLAIM_ID      | 1234        | Ethoca Bank   | User6789        | 52318413-bd05-4960-a745-f79e5c3d6de9 | null                     | null                 | null                        |

|                                                                               Test Case                                                                                | locale | cardAcceptor Name | acquirerReferenceNumber |   disputeId   | disputeIdType |
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------|-------------------|-------------------------|---------------|---------------|
| [TC3](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc3-arn-provided-but-no-compelling-evidence-found) | en-US  | ETHOCA CHAIRS     | 25559184242123254936700 | null          | null          |
| [TC4](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc4-arn-provided-with-no-matches)                  | en-US  | ETHOCA CHAIRS     | 25559198722123254936789 | null          | null          |
| [TC5](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc5-dispute-id-provided-with-no-matches)           | en-US  | ETHOCA CHAIRS     | null                    | 2000456496789 | CLAIM_ID      |
| [TC6](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc6-neither-arn-nor-dispute-id-are-provided)       | en-US  | ETHOCA CHAIRS     | null                    | null          | null          |

|                                                                                    Test Case                                                                                     | cardAcceptor Location | cardAcceptor Name  | cardAcceptor RegionCode | cardAcceptor CountryCode | acquirer ReferenceNumber | issuer AuthorizationCode | transaction DateTime | transaction Amount | card FirstSix | card LastFour | payment Type - | transactionIdentifierType | transaction IdentifierValue | clearingDateTime | clearingAmount | requestor.id | requestor.name |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------|--------------------|-------------------------|--------------------------|--------------------------|--------------------------|----------------------|--------------------|---------------|---------------|----------------|---------------------------|-----------------------------|------------------|----------------|--------------|----------------|
| [TC7](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc7-successful-request-with-required-parameters)             | null                  | ETHOCA NINJA GAMES | TX                      | USA                      | 3100000000001234         | 0A2B3C                   | null                 | null               | 123456        | null          | MC             | BANKNET_REF_NUM           | 1234                        | null             | null           | null         | null           |
| [TC8](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc8-request-without-transaction-criteria)                    | null                  | ETHOCA NINJA GAMES | TX                      | USA                      | 3100000000001234         | 0A2B3C                   | null                 | null               | 123456        | null          | MC             | BANKNET_REF_NUM           | 1234                        | null             | null           | null         | null           |
| [TC9](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc9-successful-call-center-request-with-required-parameters) | null                  | ETHOCA NINJA GAMES | TX                      | USA                      | 3100000000001234         | 0A2B3C                   | null                 | null               | 123456        | null          | MC             | BANKNET_REF_NUM           | 1234                        | null             | null           | id           | name           |
| [TC10](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#tc10-call-center-request-without-transaction-criteria)      | null                  | ETHOCA NINJA GAMES | TX                      | USA                      | 3100000000001234         | 0A2B3C                   | null                 | null               | 123456        | null          | MC             | BANKNET_REF_NUM           | 1234                        | null             | null           | id           | name           |

### TC1: Successful request with all request parameters {#tc1-successful-request-with-all-request-parameters}

In this scenario, the request is sent with all potential request parameters populated, and a successful response is returned.

#### Request {#request}

```JSON
{
  "locale": "en-US",
  "dataPolicyConsent": true,
  "searchCriteria": [
    {
      "merchantCriteria": {
        "cardAcceptorName": "ETHOCA CHAIRS",
        "cardAcceptorId": "CardAcceptor123",
        "cardAcceptorLocation": "SUNNYVALE",
        "cardAcceptorRegionCode": "CA",
        "cardAcceptorCountryCode": "USA",
        "merchantCategoryCode": "5712"
      },
      "transactionCriteria": {
        "transactionIdentifierType": "BANKNET_REF_NUM",
        "transactionIdentifierValue": "123456",
        "acquirerReferenceNumber": "20292029202920292029001",
        "transactionDateTime": "2021-06-18T22:11:05+05:00",
        "transactionAmount": {
          "value": "361.56",
          "currencyCode": "USD"
        },
        "cardFirstSix": "123456",
        "cardLastFour": "5363",
        "issuerAuthorizationCode": "123456",
        "paymentType": "MC",
        "clearingDateTime": "2020-11-04T22:11:05.000Z",
        "clearingAmount": {
          "value": "250.0",
          "currencyCode": "USD"
      },
      "disputeCriteria": {
        "disputeId": "52318413-bd05-4960-a745-f79e5c3d6de9",
        "disputeIdType": "CLAIM_ID"
      }
    }
  ],
  "requestor": {
    "id": "1234",
    "name": "Ethoca Bank",
    "userId": "User6789"
  },
  "paymentId": "52318413-bd05-4960-a745-f79e5c3d6de9"
}
```

#### Expected response {#expected-response}

```JSON
{
  "searchResults": [
    {
      "recordId": "0d5de8cb-d510-4378-b3ef-2e856341dc3f-1",
      "resultStatus": {
        "code": "OK",
        "message": "OK"
      },
      "firstPartyTrustResult": {
        "resultStatus": {
          "code": "FIRST_PARTY_TRUST_INFORMATION_FOUND",
          "message": "First Party Trust information found"
        },
        "acquirerReferenceNumber": "20292029202920292029001",
        "disputeId": "52318413-bd05-4960-a745-f79e5c3d6de9",
        "firstPartyTrustDecision": {
          "firstPartyFraud": "YES",
          "reasonCode": "CE_FOUND",
          "reasonDetails": "Compelling evidence found",
          "compellingEvidenceDetails": {
            "deviceIdentity": {
              "ipAddress": "127.0.0.1",
              "deviceId": "ABC1234",
              "deviceFingerPrint": "DAX9090989"
            },
            "deliveryFactor": {
              "shippingAddress": {
                "addressLine1": "223 Blythwood Rd",
                "addressLine2": "Main Floor",
                "addressLine3": "Room 1",
                "countrySubdivision": "MO",
                "postalCode": "63119",
              },
              "emailAddress": "test@test.com",
            },
            "additionalIdentityFactor": {
              "loginAccountId": "ABC1234",
              "telephoneNumber": {
                "telephoneNumber1": "11234567890",
                "telephoneNumber2": "11234567891",
                "telephoneNumber3": "11234567892"
              },
              "deviceLocation": {
                "latitude": "30.286254",
                "longitude": "11234567891"
              },
              "deviceName": "Iphone 15",
              "shippingAddress": {
                "addressLine1": "223 Blythwood Rd",
                "addressLine2": "Main Floor",
                "addressLine3": "Room 1",
                "countrySubdivision": "MO",
                "postalCode": "63119",
              },
              "billingAddress": {
                "addressLine1": "223 Blythwood Rd",
                "addressLine2": "Main Floor",
                "addressLine3": "Room 1",
                "countrySubdivision": "MO",
                "postalCode": "63119",
              },
              "ipAddress": "127.0.0.1",
              "emailAddress": "test@test.com"
            }
          },
          "firstPartyTrustTransactionDetails": [
            {
              "acquirerReferenceNumber": "20292029202920292029001",
              "bin": "123456",
              "cardLastFour": "5363",
              "category": "DISPUTED",
              "issuerAuthorizationCode": "123456",
              "banknetReferenceNumber": "123456",
              "transactionAmount": {
                "value": "361.56",
                "alphaCurrencyCode": "USD"
              },
              "transactionDate": "2021-06-18",
              "merchantName": "Ethoca FPT Test",
              "merchantAlphaCountryCode": "USA",
              "merchantCountrySubdivisionCode": "MO",
              "merchantCityName": "St. Louis"
            },
            {
              "acquirerReferenceNumber": "20292029202920292029002",
              "bin": "123456",
              "cardLastFour": "5363",
              "category": "HISTORICAL",
              "transactionAmount": {
                "value": "123.45",
                "alphaCurrencyCode": "USD"
              },
              "transactionDate": "2023-03-15",
              "merchantName": "Ethoca FPT Test",
              "merchantAlphaCountryCode": "USA",
              "merchantCountrySubdivisionCode": "MO",
              "merchantCityName": "St. Louis"
            },
            {
              "acquirerReferenceNumber": "20292029202920292029003",
              "bin": "123456",
              "cardLastFour": "5363",
              "category": "HISTORICAL",
              "transactionAmount": {
                "value": "38.45",
                "alphaCurrencyCode": "USD"
              },
              "transactionDate": "2023-04-19",
              "merchantName": "Ethoca FPT Test",
              "merchantAlphaCountryCode": "USA",
              "merchantCountrySubdivisionCode": "MO",
              "merchantCityName": "St. Louis"
            }
          ]
        }
      }
    }
  ]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC2: Successful request with the minimum parameters {#tc2-successful-request-with-the-minimum-parameters}

Here, the request is sent with a minimum set of request parameters, and a successful response is returned.

#### Request {#request-1}

```JSON
{
  "locale": "en-US",
  "dataPolicyConsent": true,
  "searchCriteria": [
    {
      "merchantCriteria": {
        "cardAcceptorName": "ETHOCA CHAIRS",
        "cardAcceptorId": "CardAcceptor123",
        "cardAcceptorLocation": "SUNNYVALE",
        "cardAcceptorRegionCode": "CA",
        "cardAcceptorCountryCode": "USA",
        "merchantCategoryCode": "5712"
      },
      "disputeCriteria": {
        "disputeId": "52318413-bd05-4960-a745-f79e5c3d6de9",
        "disputeIdType": "CLAIM_ID"
      }
    }
  ],
  "requestor": {
    "id": "1234",
    "name": "Ethoca Bank",
    "userId": "User6789"
  },
  "paymentId": "52318413-bd05-4960-a745-f79e5c3d6de9"
}
```

#### Expected response {#expected-response-1}

```JSON
{
  "searchResults": [
    {
      "recordId": "518092e2-aa8d-4fe6-952e-f53431c4c4ce-1",
      "resultStatus": {
        "code": "OK",
        "message": "OK"
      },
      "firstPartyTrustResult": {
        "resultStatus": {
          "code": "FIRST_PARTY_TRUST_INFORMATION_FOUND",
          "message": "First Party Trust information found."
        },
        "acquirerReferenceNumber": "20292029202920292029001",
        "disputeId": "52318413-bd05-4960-a745-f79e5c3d6de9",
        "firstPartyTrustDecision": {
          "firstPartyFraud": "YES",
          "reasonCode": "CE_FOUND",
          "reasonDetails": "Compelling evidence found",
          "compellingEvidenceDetails": {
            "deviceIdentity": {
              "ipAddress": "127.0.0.1",
              "deviceId": "ABC1234",
              "deviceFingerPrint": "DAX9090989"
            },
            "deliveryFactor": {
              "shippingAddress": {
                "addressLine1": "223 Blythwood Rd",
                "addressLine2": "Main Floor",
                "addressLine3": "Room 1",
                "countrySubdivision": "MO",
                "postalCode": "63119"
              },
              "emailAddress": "test@test.com"
            },
            "additionalIdentityFactor": {
              "loginAccountId": "ABC123456",
              "telephoneNumber": {
                "telephoneNumber1": "+11234567890",
                "telephoneNumber2": "+11234567891",
                "telephoneNumber3": "+11234567892"
              },
              "deviceLocation": {
                "latitude": "30.286254",
                "longitude": "-81.286254"
              },
              "deviceName": "Iphone 15",
              "shippingAddress": {
                "addressLine1": "223 Blythwood Rd",
                "addressLine2": "Main Floor",
                "addressLine3": "Room 1",
                "countrySubdivision": "MO",
                "postalCode": "63119"
              },
              "billingAddress": {
                "addressLine1": "223 Blythwood Rd",
                "addressLine2": "Main Floor",
                "addressLine3": "Room 1",
                "countrySubdivision": "MO",
                "postalCode": "63119"
              },
              "ipAddress": "127.0.0.1",
              "emailAddress": "test@test.com"
            }
          },
          "firstPartyTrustTransactionDetails": [
            {
              "acquirerReferenceNumber": "20292029202920292029001",
              "bin": "123456",
              "cardLastFour": "1234",
              "category": "DISPUTED",
              "transactionAmount": {
                "value": "250.35",
                "alphaCurrencyCode": "USD"
              },
              "transactionDate": "2024-01-13",
              "merchantName": "Ethoca FPT Test",
              "merchantAlphaCountryCode": "USA",
              "merchantCountrySubdivisionCode": "MO",
              "merchantCityName": "St. Louis"
            },
            {
              "acquirerReferenceNumber": "20292029202920292029002",
              "bin": "123456",
              "cardLastFour": "1234",
              "category": "HISTORICAL",
              "transactionAmount": {
                "value": "123.45",
                "alphaCurrencyCode": "USD"
              },
              "transactionDate": "2023-03-15",
              "merchantName": "Ethoca FPT Test",
              "merchantAlphaCountryCode": "USA",
              "merchantCountrySubdivisionCode": "MO",
              "merchantCityName": "St. Louis"
            },
            {
              "acquirerReferenceNumber": "20292029202920292029003",
              "bin": "123456",
              "cardLastFour": "1234",
              "category": "HISTORICAL",
              "transactionAmount": {
                "value": "38.45",
                "alphaCurrencyCode": "USD"
              },
              "transactionDate": "2023-04-19",
              "merchantName": "Ethoca FPT Test",
              "merchantAlphaCountryCode": "USA",
              "merchantCountrySubdivisionCode": "MO",
              "merchantCityName": "St. Louis"
            }
          ]
        }
      }
    }
  ]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC3: ARN provided but no compelling evidence found {#tc3-arn-provided-but-no-compelling-evidence-found}

For this test case, the `acquirerReferenceNumber` is provided in the request, but the response error indicates that no compelling evidence was found. To correct this, you can retry with additional parameters, including the `disputeId`, to help identify the correct transaction.

#### Request {#request-2}

```JSON
{
  "locale": "en-US",
  "searchCriteria": [
    {
      "merchantCriteria": {
        "cardAcceptorName": "ETHOCA CHAIRS"
      },
      "transactionCriteria": {
        "acquirerReferenceNumber": "20292029202920292029002",
        "paymentType": "MC"
      }
    }
  ]
}
```

#### Expected response {#expected-response-2}

```JSON
{
  "searchResults": [
    {
      "recordId": "59bc049f-873a-40ac-aaae-0543b75e6297-1",
      "resultStatus": {
        "code": "OK",
        "message": "OK"
      },
      "firstPartyTrustResult": {
        "resultStatus": {
          "code": "FIRST_PARTY_TRUST_EVIDENCE_NOT_FOUND",
          "message": "The first-party trust evidence could not be found based on the provided request parameters."
        },
        "acquirerReferenceNumber": "20292029202920292029002",
        "disputeId": "3f7abb82-bf15-4fe8-92d4-0a43a5a0cef8",
        "firstPartyTrustDecision": {
          "firstPartyFraud": "NO",
          "reasonCode": "CE_NOT_FOUND",
          "reasonDetails": "Compelling evidence not found",
          "firstPartyTrustTransactionDetails": [
            {
              "acquirerReferenceNumber": "20292029202920292029002",
              "bin": "123415",
              "cardLastFour": "5423",
              "category": "DISPUTED",
              "transactionAmount": {
                "value": "250.35",
                "alphaCurrencyCode": "USD"
              },
              "transactionDate": "2024-01-13",
              "merchantName": "Ethoca FPT Test",
              "merchantAlphaCountryCode": "USA",
              "merchantCountrySubdivisionCode": "MO",
              "merchantCityName": "St. Louis"
            }
          ]
        }
      }
    }
  ]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC4: ARN provided with no matches {#tc4-arn-provided-with-no-matches}

In this scenario, the `acquirerReferenceNumber` is provided in the request, but the response error indicates that no matching transaction was found. To correct this, you can retry with additional parameters, including the `disputeId`, to help identify the correct transaction.

#### Request {#request-3}

```JSON
{
  "locale": "en-US",
  "searchCriteria": [
    {
      "merchantCriteria": {
        "cardAcceptorName": "ETHOCA CHAIRS"
      },
      "transactionCriteria": {
        "acquirerReferenceNumber": "25559184242123254936700",
        "paymentType": "MC"
      }
    }
  ]
}
```

#### Expected response {#expected-response-3}

```JSON
{
  "searchResults": [
    {
      "recordId": "9a42873c-51ed-4558-a08a-8c1e4f36ab5e-1",
      "resultStatus": {
        "code": "OK",
        "message": "OK"
      },
      "firstPartyTrustResult": {
        "clientResponseCode": "200 OK",
        "resultStatus": {
          "code": "FIRST_PARTY_TRUST_EVIDENCE_NOT_FOUND",
          "message": "The first-party trust evidence could not be found based on the provided request parameters."
        },
        "acquirerReferenceNumber": "25559184242123254936700",
        "firstPartyTrustDecision": {
          "firstPartyFraud": "Not Assessed",
          "reasonCode": "NOT_ASSESSED",
          "reasonDetails": "No Matching Transaction Found"
        }
      }
    }
  ]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC5: Dispute ID provided with no matches {#tc5-dispute-id-provided-with-no-matches}

Here, the `disputeId` is provided in the request, but there is no match that can be returned for this transaction.

#### Request {#request-4}

```JSON
{
  "locale": "en-US",
  "searchCriteria": [
    {
      "merchantCriteria": {
        "cardAcceptorName": "ETHOCA CHAIRS"
      },
      "disputeCriteria": {
        "disputeId": "2000456496789",
        "disputeIdType": "CLAIM_ID"
      }
    }
  ]
}
```

#### Expected response {#expected-response-4}

```JSON
{
  "Errors": {
    "Error": [
      {
        "Source": "Service",
        "ReasonCode": "FIRST_PARTY_TRUST_EVIDENCE_NOT_FOUND",
        "Description": "The first-party trust evidence could not be found based on the provided request parameters.",
        "Recoverable": false
      }
    ]
  }
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC6: Neither ARN nor Dispute ID are provided {#tc6-neither-arn-nor-dispute-id-are-provided}

For this test case, neither the `acquirerReferenceNumber` nor the `disputeId` are provided in the request, so no transaction could be found. To correct this, you can retry with additional parameters, including the `acquirerReferenceNumber` and `disputeId`, to help identify the transaction.

#### Request {#request-5}

```JSON
{
  "locale": "en-US",
  "searchCriteria": [
    {
      "merchantCriteria": {
        "cardAcceptorName": "ETHOCA CHAIRS"
      }
    }
  ]
}
```

#### Expected response {#expected-response-5}

```JSON
{
  "Errors": {
    "Error": [
      {
        "Source": "Service",
        "ReasonCode": "MISSING_FIELD_VALUE",
        "Description": "We could not proceed with the request based on the provided request parameters. To proceed, please provide either the Acquirer Reference Number and Payment Type or the Dispute Criteria in the request",
        "Recoverable": false
      }
    ]
  }
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC7: Successful request with required parameters {#tc7-successful-request-with-required-parameters}

In this scenario, the request is sent to the `/searches` endpoint with merchant and transaction information. The transaction is found and a transaction data link is returned with transaction details.

#### Request {#request-6}

```JSON
{
    "locale": "en-US",
    "searchCriteria": [
        {
            "merchantCriteria": {
                "cardAcceptorName": "ETHOCA NINJA GAMES",
                "cardAcceptorRegionCode": "TX",
                "cardAcceptorCountryCode": "USA"
            },
            "transactionCriteria": {
                "transactionIdentifierType": "BANKNET_REF_NUM",
                "transactionIdentifierValue": "1234",
                "acquirerReferenceNumber": "00000003100000000001234",
                "cardFirstSix": "123456",
                "issuerAuthorizationCode": "0A2B3C",
                "paymentType": "MC"
            }
        }
    ]
}
```

#### Expected response {#expected-response-6}

```JSON
{
	"searchResults": [
		{
			"recordId": "0.f182117.1769020506.40067a3d-01",
			"resultStatus": {
				"code": "OK",
				"message": "OK."
			},
			"merchantResult": {
				"merchantName": "Ethoca Ninja Games",
				"address": {},
				"description": "Gaming platform where kids come to play, share, and imagine",
				"websiteUrl": "www.ethocaninjagames.com",
				"merchantCategory": {
					"code": "7993",
					"description": "VIDEO AMUSEMENT GAME SUPPLIES"
				},
				"logos": [
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					},
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					},
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					},
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					}
				],
				"dataPolicy": {
					"cacheable": true,
					"cacheExpiry": "2026-01-22T18:35:06.604+0000"
				},
				"resultStatus": {
					"code": "MERCHANT_FOUND",
					"message": "Merchant results provided."
				}
			},
			"purchaseReceipt": {
				"resultStatus": {
					"code": "RECEIPT_AVAILABLE",
					"message": "Purchase Receipt available."
				},
				"url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1769020506/52532e50-de12-49fa-9a6e-1d979a8d423c/IeOo-SDGzjnRMN2Th_PpSg/D1ua58hknSyNeh3WNFuGBtE1b3V9fJL0vOb-GeE_RkyEHd_nOCYlhRUnf8FW-7EAlzJcGDQ-sTtZUj__6uVTudnM7Nd_UMds2-WMvtsH3ngBDPGTnjO-Op8cWQY2uaJktc-DB6aed--d4Q1_IkwPUoqMNrx7bOsUPAiIqkZ2GivYaC43nv1FO6fjRuFVmxA4DWNqBBdJMS0bY2ISBmWkShLyKNQS-PKs2PS4UO68I-fcFtQVQfqe8X69X_X-UqLlcQIoOIroWX1Iz48r3pnhAqcr0cZ8wlxKH6pqHNtye2r5mD36elqWIgIUmJH4XOidlNro1w5ccHdhMNwNtkNKWV-xmHC43DuMI1xaxQDlGUVRO8fw3u38p8I8F2VU-OWrK275T8c9TkhoFL_iYmwMF1S1R_-mYTrpUkGxOaG7ym2Cky6d-XCIRixuKk_s_UKztQUWDbm5ik9_K_tJ_Grjj2zqdBqyeV9GTedjKQ9PoNyLmSK_GoyS7UZsAoT-CdGGmewWCuqmuq_UyaOZIpb1f3BdGmYF4hPbI0KVVnHKeJU3UEe5DFznTLw88b1t9XjPtRQYL42Cym8OIZr9FwIXC_DLbMzh_UQFaojxlfHEeeD4JCeVpwtPf7uWq9nO4kdlLKVNo_4fUartxnr7kCXYlW_h7QV81AKbFEnQ7JP0oThZNFKELEKIoFvkirnFFLevkcLNERnO3j1p17r7cXTF7Ctdx18O_j2l8627sokTXHP9RUMJ3RvkqZ5xBZROFkYst-nusD4a0dcygwIPy_yhJJ-vLXIWxLJa4U_kMuokA2heh0Bq6FUWTplQ9Emuth6uHbSGU0S0OVuLwLZATBzW4wm7QAnOrL-ZiRrp0gxSJKFMxf-auWb9jLmb20B8BUooAEBhrk6WHUObFRKOgFPHemeHDWckzs_mihu2GrHJGQO5Kg9Fl_-j?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzY5MDIwNDk2LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzY5MDIxNDA2LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NjkwMjA1MDYsImp0aSI6ImNhOTcyNTE1NDBlMjI0ZmIwYjU4MGQ5MDc2MmRmNGUwIiwiY2lkIjoiakRyUTlRdXdGeVczZGIzaFlpQ3VQWGJJTngxVUpUd2RpVkp4UHgzdTQwYjZiNjg3In0.TG3NCFZeArk3uEwDj4nnT_DPcdb_cBtl0CU9K1ir3Juyhkke1MjzgCVJJjfDbpl91YTMRiypW3j4te-3fcNhRZ5Bnk6aHL7qp6FE4V2coFiAS0RDQhApwmsk-za56JdYTAvP8DexMqoVnq6QnAHsXYxn4xOxqQWQSS2cyWemOqKwoLTYfXCnXnGlw2SxU_RTaA_Fmc6it_-Psu5VLfyw6CbZCiPeVv8-Lf5ecraopFPH5IV3Cvg1OYkwfUsT9WkO7XtG1jAUgITb15jlHtYeAeHAA8x1l7oNPNXWm1Qng1Xl3WTsz06HrJIdaR9NMCxsFuAnmxlu3_KAlEPs0wAnzA",
				"contentType": "RECEIPT",
				"expiresOn": "2026-01-21T18:50:06+00:00"
			},
			"transactionData": {
				"resultStatus": {
					"code": "TRANSACTION_AVAILABLE",
					"message": "Transaction Details available."
				},
				"url": "https://sandbox.api.ethocaweb.com/ethoca/consumer-clarity/transaction-data-link?locale=en-US&ts=1769020506&key=00bb69c7-60a8-401a-909a-f06733845e32&iv=PAax05HC8Hma2jQJmFUegA&data=EoG89g-_q8uj-c7HWlgPDi_07cfVfdD4ywsC2p3LchO7gN-qZDTf_AxCq7ESKPfsOYMaus2f5tkzF0YNVr7ZOxl3iLF0OAiXy7z7P7n6B8d0Z5uriJllEd5esRy2ZWZBaMdCx4Ye2k0Dvp66Q8NH3iPRdUSqMbeXh8zC50JQKmpJ6-Z3y245f_d4Rt5GiKorNlY1D1mZ4o4tklPXXkFU8J_5UEPVQ4lxcunbTjyIWenwwgbKqtyi8C7BZd64KWBlHN4wBVUMMYbvBEapBjnlwvlQ1w_TYC68_plGzsKIGKC9PgNmQYinmmF3dVJkSDoBcCdC6gQq1PW8KhRHA-LllRvPVsJvqzeTjzCAIKr9sEpssKfMN-xsYDZaKjOHNB8st4DlO3ePff5Srgi1mjzdwPy_w3wnCJ7GPWSpu9WANSFYcmcSowrijW6Oo7L9Jsru4xAXnOiQUIdHFWK1mtrItRS-NcaF8MZiHWo5Y2CPmd2P2wQTrD8is7Lpvem07Gypi2KLJfFnPfcduDv_K15k7vDva3OSW3JRiCYGj89hNQ66Z-exJpMsmB2ntBvtEDsBXoB6MO78hqZC0PQb6xUKGdoLHXvtes_RWPEaNFMESP9v-9cuQv4cU87hwRLRyWpIzMQYrHdsvlgHFXUJGRmcIhQBiLqkdvkfm1HmpGxswgwKbK6xASdc7ijo-Noq21zegOBYlE7bbIu-NviZbD0M5YWErd8u6p-HVl-dI0is0IUQAOhjaVR1FmGAf4FHtb9i2KBkPwZ0DnAvzLpNRueZieo5KFsloSU4vxrryb1L2UqU-FJFawlSSPYKRGwc0AYerVf9omsH5Vgz4hF-qNLG8ecUIF9vW_76KxmVAZAsL5l8IG3PsjV5LWZt7A8THJHmDBYCn-H6S2k24zVyZzUn7iyRJtr2gac1_Ftwvk_VVv3cYv3wf1hT&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5jYWxsY2VudHJlYXBpOmNhbGxjZW50cmUtc2VydmljZTpjbGFyaXR5LWRhdGEtc2VydmljZSIsImdycCI6W10sImlzcyI6Ik1BU1RFUkNBUkRfU0FTIiwidHlwIjoib2F1dGgyX2FjY2Vzc190b2tlbiIsInRpZCI6Im5vdF9hdmFpbGFibGUiLCJhdWQiOiJFdGhvY2FFbnJpY2hlZFRyYW5zYWN0aW9ucyxFdGhvY2FEaWdpdGFsUmVjZWlwdHMiLCJuYmYiOjE3NjkwMjA0OTYsImdyYW50X3R5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJleHAiOjE3NjkwMjE0MDYsImF1dGhUeXBlIjoiT0F1dGgyIiwib25lX3RpbWUiOiJmYWxzZSIsImlhdCI6MTc2OTAyMDUwNiwianRpIjoiMjBhNjJlZjdkM2Y5MjIzZmY5ZWEyMDA3MDNjMmFmMjQiLCJjaWQiOiJqRHJROVF1d0Z5VzNkYjNoWWlDdVBYYklOeDFVSlR3ZGlWSnhQeDN1NDBiNmI2ODcifQ.IjuSIx3E7vHkMrCT_P-7_hjD6iyfu9TVoUiuce7BuNOz4Opi7tt__HOiCNJ0-CriNSdeMKmOx1jITLLAUeIQd7bea-jaFLMCjZmvDYvCu63kinNv0Sj17ETswGknr74jSTVJg199ljcDK0DpxKKQZa1veI2cj4KL3nuMQ8aBVi1W0c-M6GM28e_OYjcLd-3FGJ5wfBXC2aFncJvh3NX8tFagRt0zve_p6QzAvr1TUu27leEVn_Cf23Je0_TeyfOPlpnW8tY075JS3LaJpIuCASQe6tDUrntxGhYulpJq9qnFEuKwQRFGdxghQNKaSl58MsLyW39p3hwdyUBVvpKveQ",
				"contentType": "TRANSACTION_DETAILS",
				"expiresOn": "2026-01-21T18:50:06+00:00"
			}
		}
	]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC8: Request without transaction criteria {#tc8-request-without-transaction-criteria}

Here, you see a request that contains no `transactionCriteria`. As a result, the transaction can't be identified and the transaction data link is returned with only merchant details.

#### Request {#request-7}

```JSON
{
    "locale": "en-US",
    "searchCriteria": [
        {
            "merchantCriteria": {
                "cardAcceptorName": "ETHOCA NINJA GAMES",
                "cardAcceptorRegionCode": "TX",
                "cardAcceptorCountryCode": "USA"
            }
        }
    ]
}
```

#### Expected response {#expected-response-7}

```JSON
{
	"searchResults": [
		{
			"recordId": "0.a9f7d317.1769020834.adc4de4-01",
			"resultStatus": {
				"code": "OK",
				"message": "OK."
			},
			"merchantResult": {
				"merchantName": "Ethoca Ninja Games",
				"address": {},
				"description": "Gaming platform where kids come to play, share, and imagine",
				"websiteUrl": "www.ethocaninjagames.com",
				"merchantCategory": {
					"code": "7993",
					"description": "VIDEO AMUSEMENT GAME SUPPLIES"
				},
				"logos": [
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					},
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					},
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					},
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					}
				],
				"dataPolicy": {
					"cacheable": true,
					"cacheExpiry": "2026-01-22T18:40:34.940+0000"
				},
				"resultStatus": {
					"code": "MERCHANT_FOUND",
					"message": "Merchant results provided."
				}
			},
			"purchaseReceipt": {
				"resultStatus": {
					"code": "MISSING_FIELD_VALUE",
					"message": "Purchase Receipt cannot be obtained due to missing transaction criteria."
				},
				"url": "https://sandbox.api.ethocaweb.com/ethoca/receipt/1769020834/52532e50-de12-49fa-9a6e-1d979a8d423c/KSosu7MGFY_uxzTlWvjqBQ/wUDdwrQLnI9ep5KPnV8jWYbadvMEfQBCy8KSadmMILrBsTZ1gWTNHmNRfIXElcHpYgeRET73NyCVHoHovgoYQfjI6A06buuNJ48hAOazyofjvPqzjsDYscuwYmejcKtFtemnj-f1Q0kJ5lvSnxb_QopfxkZy_22bKAcefqFFKFJ5D9FLCTxOeL43yPE1FS_xykbnpupP3iYXxQ5JnCaMqEwWhBTEzPtaoJh68Ch7pLAbkhHCeBz9VvpsqkP91eYU2qyZTiBTCTBAfJc-wrlnKK0HPEhQlY_lG5e1RKBX4EKfqJAHngbHGbN1dcPRvU-PzEXZ1DzVty5sddn73TYQVozrkixAMKdbQjmf63NJtUQMzGQRDdk2oWnsGVCumMC8Zg9tsI6dnbPN6gZFuvOqRs4TNh2Ex-wLW1ws-YkaoPfVdzKbbPjpU0de-UHtOD52bpjSb2HDeo2F9N9Gj_HIa_xgVkajrwdcdpCcobkvbdnMnmj_jSGftmylGME4O5UVcjsiO-03Ka4DMPEGXuiPeLz_Z-mtbXxYlPzSvwfDo4qkuuebzuJgg2jAsHU8g-ozT-v1P49e9L1s6L6as0ILFgQ6ArNs2zmlSgpU9zpzBDt4O5v7vKL7nJC4-yFk3NEwWVlAcE_znlYSou_lpNel6xzqjnEdkz6a7_ZJDPM3_hqOSkKee_hKG7M07dp59rbytR2AoPnU35RAcmckbH7BS5tihej2jvvDZLl-140xOCFFxVM5m4P3YtDmKiX1aIXvVM4r_O9KSxdRiQOOc_NdvUqhST3iwFIjxamDrCNW?locale=en-US&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5yZWNlaXB0OnJlY2VpcHQtc2VydmljZTpyZWNlaXB0LXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzY5MDIwODI0LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzY5MDIxNzM0LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NjkwMjA4MzQsImp0aSI6ImNkMDE2MzUzMjc3YTBiYjQzMjY5MGE3ZmJjY2Y2OWUzIiwiY2lkIjoiakRyUTlRdXdGeVczZGIzaFlpQ3VQWGJJTngxVUpUd2RpVkp4UHgzdTQwYjZiNjg3In0.L2GxYXVTbhq-9LKiO_BO1VcSNBAEWtA8duhaCY1oUrotFSiYvVnWGkVcsWPe4w455dVpkF52V09JmvIF66LDb5EW8BX3drHWS4vXa3ZGL-0RHPWtFUNurLkjwogYVHQ3-5p20NIc4tCWLJ-N5arRj_fE0MTSwez6kNA7rOgQ8U58dAF23cHpIHkQg-RV3MqYXEv_zeJAoQmiIdAz7CSfv3j302TXVu4mHYK3DpfUs-zFcfblVdvDoFW_h7U2ebujfN0YcAUWTVH5oOHjHBB-_75kNvJbqhSZULyMN-nN3L7zMJIn7vRQrolp4T85By9i1dtJA5_zWrUIh7LF7rJ2cw",
				"contentType": "MERCHANT_DETAILS",
				"expiresOn": "2026-01-21T18:55:34+00:00"
			},
			"transactionData": {
				"resultStatus": {
					"code": "MISSING_FIELD_VALUE",
					"message": "Transaction details cannot be obtained due to missing transaction criteria."
				},
				"url": "https://sandbox.api.ethocaweb.com/ethoca/consumer-clarity/transaction-data-link?locale=en-US&ts=1769020834&key=00bb69c7-60a8-401a-909a-f06733845e32&iv=nWjONJuX-7VoT4YASojzWQ&data=kIvL7pPJUCHXRfG-BgFlV9y5WuZlJZJPuf9k3mKqHa0LU_ZAgmAg-r_9MjFNLfe_aHuCo7UL5BJ0Vj8hdKJi77GMd4jYiog6ABQWGg435dtLFwdC1Z3AVwpQBZ0p4LyGF4rBqzKnfYxwqx4LGL9WgWTiQ8L6HUAMv5PbsY-BBcYJY4S6QUb6EsXrHQdw2GR7i9jEVvFP7m-0K9MsNV5uSZXQy5abWQZ8nY6ivpBcReHaXzL7SxTey_NM1yGIKMLLB-GHmKqoGTPIDuYBSX79yrKoJrtST12ERSH9K9D7wE8hYhpTY75VfQhM5qxmRYPUV1D7VT3UmynB_yxF_MNWvU_BMsobd_8BMZ076K1rrnXhMHRUNScvwnsYvdNUmq8nED6Czj47Cm64x6clpOQtNGN5TEmhROwJwCcaKRAXpprk6RWIdBYWLIR3k7wPrVYZxec6ekMX_h4DAAzBPSbMp1JJ5Hw3v-pUNrEOvxHQ0fZPoV74ij1G-EozFt2wwS3iy9ELnDR0sFdh5Jp5WvGiCmPBO6LG8IAx2o7DGJLH3dykGECnQbXtgIzrtp-c-CkcUXf3_jprjS1V_nGvV7aeKaGFLTful-UfLZ7sy7OmyRqk5LluTKzprOuw3zLAFdKleVGEtEVuFfoGqTYOjfEB1AP_SHyEpSQu7n8nXJAmFtEqOxeSTPBBPOzEw7i-p9c8LNkEd186SaVPxqONbHXBtOf_geK9YIkUYbvI9Nf942LdAjAIUM_E-yYyYtX0y8XL94OGXqH9XFS9Z_D2iLA9PKnDEHhjlfNaodmmfPvF&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5jYWxsY2VudHJlYXBpOmNhbGxjZW50cmUtc2VydmljZTpjbGFyaXR5LWRhdGEtc2VydmljZSIsImdycCI6W10sImlzcyI6Ik1BU1RFUkNBUkRfU0FTIiwidHlwIjoib2F1dGgyX2FjY2Vzc190b2tlbiIsInRpZCI6Im5vdF9hdmFpbGFibGUiLCJhdWQiOiJFdGhvY2FFbnJpY2hlZFRyYW5zYWN0aW9ucyxFdGhvY2FEaWdpdGFsUmVjZWlwdHMiLCJuYmYiOjE3NjkwMjA4MjQsImdyYW50X3R5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJleHAiOjE3NjkwMjE3MzQsImF1dGhUeXBlIjoiT0F1dGgyIiwib25lX3RpbWUiOiJmYWxzZSIsImlhdCI6MTc2OTAyMDgzNCwianRpIjoiMjAxNmQ5YzNmMzM4NjA4MDU1YjNmMDQwMmVjZTRiNzciLCJjaWQiOiJqRHJROVF1d0Z5VzNkYjNoWWlDdVBYYklOeDFVSlR3ZGlWSnhQeDN1NDBiNmI2ODcifQ.jumYmss9wAG265_DoCX-SXAzYMXx5vrtPSdzaA1S_wC7gu8M0DtNNRXo97KbFlxpf3NTTYlL1hYRcrCz0uee9RnhBEkU9tAOUuUQXE43jUKJphRzzSZiCIzGqXPqCLgeQgmCkOZR2SDDBBItjk29zL7nrTUUt62JsolfmXPLrS2Pv0VoTnCTy46fon6Qn1P6izWnMalyceVH2lOfpYVevI5g-hUWYmL3jguitUNuhMbEEnxgeKvBSKZy94qGXfcoZu1WDgYfkUcCzWtDhBhFsXKZBcbOZDluTkRPVInNzDTB7jlaFUgadVAs_cGWffsPaEuHV_TU2MJaXiRCRTtZqg",
				"contentType": "MERCHANT_DETAILS",
				"expiresOn": "2026-01-21T18:55:34+00:00"
			}
		}
	]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC9: Successful call center request with required parameters {#tc9-successful-call-center-request-with-required-parameters}

In this scenario, the request is sent to the `/backoffice-searches` endpoint with merchant and transaction information. The transaction is found and a transaction data link is returned with transaction details.

#### Request {#request-8}

```JSON
{
    "locale": "en-US",
    "searchCriteria": [
        {
            "merchantCriteria": {
                "cardAcceptorName": "ETHOCA NINJA GAMES",
                "cardAcceptorRegionCode": "TX",
                "cardAcceptorCountryCode": "USA"
            },
            "transactionCriteria": {
                "transactionIdentifierType": "BANKNET_REF_NUM",
                "transactionIdentifierValue": "1234",
                "acquirerReferenceNumber": "00000003100000000001234",
                "cardFirstSix": "123456",
                "issuerAuthorizationCode": "0A2B3C",
                "paymentType": "MC"
            }
        }
    ],
    "requestor": {
        "id": "id",
        "name": "name"
    }
}
```

#### Expected response {#expected-response-8}

```JSON
{
	"searchResults": [
		{
			"recordId": "0.91292117.1769026676.de33763-01",
			"resultStatus": {
				"code": "OK",
				"message": "OK."
			},
			"merchantResult": {
				"merchantName": "Ethoca Ninja Games",
				"address": {},
				"description": "Gaming platform where kids come to play, share, and imagine",
				"websiteUrl": "www.ethocaninjagames.com",
				"merchantCategory": {
					"code": "7993",
					"description": "VIDEO AMUSEMENT GAME SUPPLIES"
				},
				"logos": [
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					},
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					},
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					},
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					}
				],
				"dataPolicy": {
					"cacheable": true,
					"cacheExpiry": "2026-01-22T20:17:56.410+0000"
				},
				"resultStatus": {
					"code": "MERCHANT_FOUND",
					"message": "Merchant results provided."
				}
			},
			"callCenterDetails": {
				"resultStatus": {
					"code": "TRANSACTION_AVAILABLE",
					"message": "Call Center Details available."
				},
				"url": "https://sandbox.consumerclarity.ethocaweb.com/callcentreapi/en-CA/index.html?locale=en-US&ts=1769026676&key=e172ed38-778b-f51b-29b2-0f9737544®ion=USA&iv=v8ROwcQkkLqFi_OaYWlbuA&data=WWvD_6JYZ6fR2YCnCApyBSnEpcY50PZnULxHW9Nwsq-_RhFq9VAmaE-a0yvr7ng4ZfTIss05f3k2oDgEANw-8M5z3O5VvNDKDQugdSglYfkojMfwSTmxsATQamrP3321g0v3R-1LIxvXhHtEse-We_AGFRDR_WyC7qkdZmfkzcvLf_LzFjhBNiAbqvtTLygfHYUD9FKsBPPy_KLN_uMWNMlfjdAILrfoZFirTzqC6Z_WJiWX-xnf0HjXTWcpZziSvaf5l4eDSo3ibgGwCabjst-MgnlJ2TPSE0WgWHRn6HwT_-mOZn1j_NZ-pU-bxk-iK7VWkBezzS-XXr6aUr7VjlJNosMrPWS9whjP05dsnTkcoUl0miVp2lZALrJc9U8JZuaEUwWDm-LjuixWsx5dSeYkj5g35LNF_jfyWxUhcKfR951TlBj-Yklz1aX3fuc8HgNOPYiMj_KaBAs1N_XFj2xWQ0NR1_OyqnFjSS-110y2zvR4ZMUeNvcOQNhuSLGz1Hv6aZy3MRHbqQnPN8yJxYiNqKyV2rRXWI3heKUXpJvKJZn1rMdsQHnBmc6Tw7lghafZ1Wvcx82LhnuzrwWECWXCTw-SW14rU8sE_Vc1RG3Yl9Mr053wOUG9EqhA-c4j7o8gYJ4SVCRyrO4JBOUHDSvuwzIEog0I9fOMBQw0RZSpJw6MZQAZ9gYLTzF74899OWbvp5EJ2c38bPox8jo9mqnmblusNx2EtQ0bbrM9ZKzPUmZ1C0riGytnUY74WW4a6i7CWaNm8vc2P_MXrissxUujeRP26pFN-rNJZ4h1oyyM05pPvicUzFOfsVmRtDuMcwy5m9Nv5TOP0n03Wp9LTp5eDI9pgbsUs_J1rHKkh21eeganV6gEHyo2czi1Tf3TezN7jtvC39EEtNiT4fuYoXrB45cpETTJSsAye_Qhrnica35TorXFbHvxaSD0-MNLRjnA3JXVHVnVEJiddxIlE6ozQG13g0EHBSgM_IFzpts-ELeOCJOlLBlD3glNEgRE54N4HqfxExvScJTfb8kGDxasEGSvdckRpcCdiZtvunO7HW9PJXTDABqSSoT5wHSb3AYzfUiWd3hqKTMmedba0MQSuR_s&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5jYWxsY2VudHJlYXBpOmNhbGxjZW50cmUtc2VydmljZTpjYWxsY2VudHJlLXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzY5MDI2NjY2LCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzY5MDI3NTc2LCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NjkwMjY2NzYsImp0aSI6ImMwNTI1NGU3ZDYzNDkwOTM4MDFhZjY5ZTRkNGMzYWIzIiwiY2lkIjoiakRyUTlRdXdGeVczZGIzaFlpQ3VQWGJJTngxVUpUd2RpVkp4UHgzdTQwYjZiNjg3In0.IZdUUE_fcLL7LwzsPgH1iAnsOllmK19rdx44505nxYmnUKKmJwrwdoqsAqlFy62ixLknZfRGDUMpTTFK6QTM4uG8M2OGIq11FZzC1J8n1bHUb8u2vxSNVESVhctMWkfbu8JcbpeyXteyNXxcIETRId5k0HT_RfRnK2Zcv6IsC9vIa_L5oqoWAueiJnnF_mNWJl3md_l_Z1-inlSDEGowQwDrHbQkeWiIBa2gHJLJ1OZT3-u2BtXRUl6Y4w-c_umnV1n3-lTR-KAtgd6gBbcfkmzyga_EX7L6p1ged3sjomouMITxchhxf0WrCaoMzriCBrxp6p-eyX191mA2qy4_DQ",
				"contentType": "TRANSACTION_DETAILS",
				"expiresOn": "2026-01-21T20:32:56+00:00"
			},
			"transactionData": {
				"resultStatus": {
					"code": "TRANSACTION_AVAILABLE",
					"message": "Transaction Details available."
				},
				"url": "https://sandbox.api.ethocaweb.com/ethoca/consumer-clarity/transaction-data-link?locale=en-US&ts=1769026676&key=00bb69c7-60a8-401a-909a-f06733845e32®ion=USA&iv=DNNtDBm7eztHRuEuRdcQ2A&data=nOA-1BwRYWm8_l7jySPCcL0dwOvOek-kglEFi3MZ_CsMctoD7ZLxOjyVBROcRNdbH5w2ymWl70jdJi4bCV4_-rOH3C65yeCTjpvL0ggKrcDyyvsqir8HUS36i11NgtF-qC9PN2GAGc5YqMXZfUf38tQvXgmJPxaFVoMQlXXhQqC99kIVukwnOn6HeSZO7alnc7zxgh1HQGiNGfVE0oGqWRaLVzzdM9lJGkxWIlx-giuBgD00zS4JdIoI7DS_pwA9ewQVCKtLgEAwChzVyRa01J7tZ4uBaPtqme2fzyo6IJ68CqyZirYV3ijDqgcQu4ZvaycBe7dlaHMXlS62oahcWsi2TbBld-oDQZWUzLzQ872gZGqL_J7jSak-rkqsED5DsFxQlDlwKrlOCMMPZ-9Qf4GlNHPZmenIVo58Y8qeY9S9akNHh6vBWYu0VKVG-3k2vXDSuc0VaYFlmYHSGFEJgwGXJiGoSeCCm1Q4DRJHgLUz3aT7yxNuJNEWoCwYR3yTmNPvHAvI0mciSVWDT-AOeF2LtkfF-y4urq-ycSL9tMxmm-B9mc3NoJ--zDQDqyFQwAUYK5RftJjunCELXrX822n6rrkvsBqbwwEH6xH7bWG8seRl5PNmxHpPUbzT08i0aPLSS-v5fqKBj-kpzsjaCW3peZbxErJMlSvtzvq9itof067o2p_qIs6SJqbC_8Lbn1uiWIBMxm7D9jg5jE_4jW3PFtowdGOOTo5sy4ruQmmzqmSPNrao6kdIvo1AZkr3VLUKGD43v3RunK6kcNQBeSWg2JEfVME0u3wtqDerQTDMKCk-MpOxpFC9e5eo6-6sKAfy3TRYwcHB_SIwYgn-35wQ38nUSYg-dKcw_9XnZ_tw9RI8kYEqP3mF-7iuwnUz1RxuxMof6CArpIkzUuGSWP6JT1RXoDjAGFStTd5poacCTaqwCdo4KJqok_mkCFVjfWi3_Z5HwPyrgOmjguA9bSh-UenHGxHXLdGPqtkHEVVKZwmC7K-MpmhD2xIG2abq_eqXS_UFdW3eBTVSjBZHRI_l4qH58PVm-Ll3BeNo3CiZjFN5Lc1A0kKmwF1sZDjxBv8i4Wjxeqi_&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5jYWxsY2VudHJlYXBpOmNhbGxjZW50cmUtc2VydmljZTpjbGFyaXR5LWRhdGEtc2VydmljZSIsImdycCI6W10sImlzcyI6Ik1BU1RFUkNBUkRfU0FTIiwidHlwIjoib2F1dGgyX2FjY2Vzc190b2tlbiIsInRpZCI6Im5vdF9hdmFpbGFibGUiLCJhdWQiOiJFdGhvY2FFbnJpY2hlZFRyYW5zYWN0aW9ucyxFdGhvY2FEaWdpdGFsUmVjZWlwdHMiLCJuYmYiOjE3NjkwMjY2NjYsImdyYW50X3R5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJleHAiOjE3NjkwMjc1NzYsImF1dGhUeXBlIjoiT0F1dGgyIiwib25lX3RpbWUiOiJmYWxzZSIsImlhdCI6MTc2OTAyNjY3NiwianRpIjoiZGNjMmRmYzViMzZmNTY5ZjFkMmY3NzRiY2Y4NmQ2ZmYiLCJjaWQiOiJqRHJROVF1d0Z5VzNkYjNoWWlDdVBYYklOeDFVSlR3ZGlWSnhQeDN1NDBiNmI2ODcifQ.JTg5iZxsO3rsfUQpqLacGextSRdrgAMBPeZ1zcXwOFeoUXaBWrLl3N4lxKhw8rT9Zr-c974Oo1r2WK5gVkK98ogQr4XNlL_6yoPP_V_C1p0aAgKQBi7NVVY5uES8LHpRON52s_vk3PiSClYkLIWRCMzHqr54UpwgFGMFDAdmtP5e21zddLMOCoEKHNJV3LwgmrE5dBr-eXeyoDOUgidOQXSzrB0K5ibAh4pne4-OiQTDJbryQOUuJJ1X0TA93y4GMDSJqCHzPXENCikuwdAmkH1xC2hXD1woA0lRyLmdQOf5jIuI5mTDBnvxru4T4YHPK7kJMouaaaxQc7nYfBekug",
				"contentType": "TRANSACTION_DETAILS",
				"expiresOn": "2026-01-21T20:32:56+00:00"
			}
		}
	]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

### TC10: Call center request without transaction criteria {#tc10-call-center-request-without-transaction-criteria}

For this test case, the `/backoffice-searches` request is sent containing no `transactionCriteria`. As a result, the transaction can't be identified and the transaction data link is returned with only merchant details.

#### Request {#request-9}

```JSON
{
    "locale": "en-US",
    "searchCriteria": [
        {
            "merchantCriteria": {
                "cardAcceptorName": "ETHOCA NINJA GAMES",
                "cardAcceptorRegionCode": "TX",
                "cardAcceptorCountryCode": "USA"
            }
        }
    ],
    "requestor": {
        "id": "id",
        "name": "name"
    }
}
```

#### Expected response {#expected-response-9}

```JSON
{
	"searchResults": [
		{
			"recordId": "0.f182117.1769027063.42404052-01",
			"resultStatus": {
				"code": "OK",
				"message": "OK."
			},
			"merchantResult": {
				"merchantName": "Ethoca Ninja Games",
				"address": {},
				"description": "Gaming platform where kids come to play, share, and imagine",
				"websiteUrl": "www.ethocaninjagames.com",
				"merchantCategory": {
					"code": "7993",
					"description": "VIDEO AMUSEMENT GAME SUPPLIES"
				},
				"logos": [
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=400",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					},
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/industry/dc89e352-3856-444f-b8e5-9996f3a06844.png?size=200",
						"type": "INDUSTRY",
						"altTextTag": "Video and Game Rentals Logo"
					},
					{
						"height": 200,
						"width": 200,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=200",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					},
					{
						"height": 400,
						"width": 400,
						"url": "https://sandbox.content.ethoca.com/b/merchant/9ad4e625-3b95-4d18-adbc-f607f519881d.png?size=400",
						"type": "MERCHANT",
						"altTextTag": "Ethoca Ninja Games Logo"
					}
				],
				"dataPolicy": {
					"cacheable": true,
					"cacheExpiry": "2026-01-22T20:24:23.394+0000"
				},
				"resultStatus": {
					"code": "MERCHANT_FOUND",
					"message": "Merchant results provided."
				}
			},
			"callCenterDetails": {
				"resultStatus": {
					"code": "MISSING_FIELD_VALUE",
					"message": "Call Center Details cannot be obtained due to missing transaction criteria."
				},
				"url": "https://sandbox.consumerclarity.ethocaweb.com/callcentreapi/en-CA/index.html?locale=en-US&ts=1769027063&key=e172ed38-778b-f51b-29b2-0f9737544®ion=USA&iv=1huQO6AKjPVDQ5myZKN5GA&data=ZUzq4xBOxnCBmtBtgPSQy7rJfXSMwHieSDb2xurxUVN90sAWxUsLbEHzsSngc07Aum3dlGstzxWQL6P8BLSAGxBkTB4aKlxmium04S3ZGCh0mOwfnZsiPcqdJ31YlghGeYlgkQPu87LuY07Jy-E_fDIej2sT8nm0BGc2YlvXR-x1DJB3YRECGM94IU8KR7sLSSqONYfcIe2Y0yASVM_im9i9or470QH45Jkjvl9Nc00wmk1_IV1cdYg47JPbMeDVz48cMJ3LlnVLZmJWwV-T0Z954acKu9cc6WddOHa7U3ndlhycyuseY1ZgAXhpH2OqZIW3nulmJJp52LZz-MacMoDwgrf7CF0rn2MP-KJsujmDP85LU2uVgGU7d4FmDzsgG1xKPIrw5wttH191O-nLJh0_wHa0yJxfmKd7XrjVOgLcH9Tif-odErwnp2d0saRwPlNjbkA8ybg39bdHjI0ce8DC_K6oZmbEEMMR10AVSrNUNy-FMPbXfIXWrGzF3KNKiyDRXylC6Y35piNKzx4QfbkAmIvdytvQJn1TmwQdPndkUE6Tdi_mS40VX-KBhd0E0l49B3JdmE_06BJeMDt15NF_FpsmNM7WYHWf2j4u2rDxQI7bJhXVnfAWU_J__5w5Fgw8OWOLebfrpob4IgdN_SFIu978RiSuBV5Kc0A42-XvXNiV9BEd5a4tBZmvGXjSrzQr5x8aNWciR5-axQTcLv5n_x4-DR7U2rGD6jCETMKNBM2f7QmxpBtW2p0YmRGy0E0BviXwkPwtl2tu2_Z6DqY3VvidWBQBHgzlolUtC5-TIb_RFjlFB1WgQeoe94UgRLJgceMzRE-sQl74Xk6ZF0fVTfJgHUDnr-HYSU_XH05kVpwSAyHdBOV5BYAlDireLbhuCiNjmh_TQFdK9o8_-clD29lmxcGE2aazo4tiXdwfCTrHXVSEYmyefDjeN239XfPwtuB_G_m6p2Gu&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5jYWxsY2VudHJlYXBpOmNhbGxjZW50cmUtc2VydmljZTpjYWxsY2VudHJlLXNlcnZpY2UiLCJncnAiOltdLCJpc3MiOiJNQVNURVJDQVJEX1NBUyIsInR5cCI6Im9hdXRoMl9hY2Nlc3NfdG9rZW4iLCJ0aWQiOiJub3RfYXZhaWxhYmxlIiwiYXVkIjoiRXRob2NhRW5yaWNoZWRUcmFuc2FjdGlvbnMsRXRob2NhRGlnaXRhbFJlY2VpcHRzIiwibmJmIjoxNzY5MDI3MDUzLCJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwiZXhwIjoxNzY5MDI3OTYzLCJhdXRoVHlwZSI6Ik9BdXRoMiIsIm9uZV90aW1lIjoiZmFsc2UiLCJpYXQiOjE3NjkwMjcwNjMsImp0aSI6ImY1NTU2MjFhZWVmNTIwZDZiY2JkODU5MTU0OTY1NjUzIiwiY2lkIjoiakRyUTlRdXdGeVczZGIzaFlpQ3VQWGJJTngxVUpUd2RpVkp4UHgzdTQwYjZiNjg3In0.V6-1kzup32o516HaxrgIsu6t2GUBtLTz-6MRpuNb1_WuXNl0qZDq5ebCsOW9UAFtQhnXj1Q-A_63490eqnm1KKTQsVnuHY0ERQjPvSQECVqmWs0tzfIwwt0XPhC2waIcbJPbZ7j1_fXY4u6vnCjCpWkUFB9VCn6qfxY-dMGjJxJp74n8f6IOTXhfXSR4A2qGSLcf3cf0vBB5d7yr3uBhLz34TKNv-P3tN9qEoLhjhMum2bp-4RNUmXrg2gHs2o8j_tDlTLtELQjdzWKpg0RNJICXJu0B-IBqtuJPrAhtR3WhsWBVeLHBqOkyS0spGBWfXsjbf6_4cOXbe6qFn3DONw",
				"contentType": "MERCHANT_DETAILS",
				"expiresOn": "2026-01-21T20:39:23+00:00"
			},
			"transactionData": {
				"resultStatus": {
					"code": "MISSING_FIELD_VALUE",
					"message": "Transaction details cannot be obtained due to missing transaction criteria."
				},
				"url": "https://sandbox.api.ethocaweb.com/ethoca/consumer-clarity/transaction-data-link?locale=en-US&ts=1769027063&key=00bb69c7-60a8-401a-909a-f06733845e32®ion=USA&iv=gRxhi2GmzO5da3dDK_Zatg&data=RI6uQP2m6pslsMSa6Hj2ngBLWEcwLusIaBGT_cGtZxA8SDnDNKd7_eVqn2OQjo6wCw_GAQKlVT3cmI-3t2Cj_c6wg-ZdbaJfG-eX1h0K1SpN8BMtJf9g4xegJocjoMYNoR7F3yq5D-tbRFOFM77VbC1n7sDTimojl528E5U1UW2Apyf37CWRjf8pcZPSi89lkniUM3Wc4ONaIyNuIGCJIY-F63skhEjr8updTfFEG4Si7J0xBEpos4zHQImhXjMlWUwtA1lqN7kQLUCN2CatPjsRj3B17PNpbXqRQBTJ-kZ6-nTHZdH-M1uCY_6vidPl03XjbZJRqplO4qkwK9DjbYwBlYu1vlY54cmkV5Z8LYdH9erMaMmWWP23waWeAgqP83y_h3d4NdBD_kWsDp5MddEjoQWY8PPWD0n1Bzs-lmq9bWMri7E9KTu14l_d9Q995MouhAia4bT9A_zQ_2ywmWTVymxGZIFfFXS2aLKCK3gAzNygt1JiWy1BfbhN5TBraaBmcmvp3s9oedILD8BEwz0uUu5m6SQrU6nn8HujyCCYeFse8Qib8JgW9GvX9lCpn1wlZKAvJdmRL1H7MA_wSIvFoE3odHXyCv4mJbaZ0GEFHPa42eOHCgigzrWu1ZUoDG_nc6xRu-TmkXMgpVOVDR2Yi10euJGBOkUg4jnLLU70ITkoiBg2wN8p60W11VcaF8r0idLGwzik3BjAh648NXU-cZxb7wc1J6lYI9XfoJUCowywqj1jhy7edgbmAHk9GLvJZQ8tUUTB-hg0NYt4eZJZVJNmt2MjJVa0SlDXK5eEZCiaeB63dkT-Uh9sqDjnht4Q0SRTqccbfV6BxlVTS8mYd6MPV8ET8Uphvxw-4WZK9VeXc8NMstDn9Gk5PzDkUL51o0mPptHWogt8af6OvC-CeLdYBiBmezi-SdoZdCNyOgzQKKpEa4VQVNAGGCzW&access_token=eyJ4NXQjUzI1NiI6Im1nVG8zWGk5eS1obWwxTWpydTlNWTJkTkJCLWZSd3NEaGlNRDIybHA1dW8iLCJraWQiOiIyMDIwMDkyODExMjUwMC1TQUFULVRva2VuLUVuZ2luZS0yIiwiY3R5IjoiSldTIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJ1c2VyX2NvbnNlbnQiOiJmYWxzZSIsInN1YiI6Im5vdF9hdmFpbGFibGUiLCJzY3AiOiJjb20ubWFzdGVyY2FyZC5ldGhvY2EuY2xhcml0eS5jYWxsY2VudHJlYXBpOmNhbGxjZW50cmUtc2VydmljZTpjbGFyaXR5LWRhdGEtc2VydmljZSIsImdycCI6W10sImlzcyI6Ik1BU1RFUkNBUkRfU0FTIiwidHlwIjoib2F1dGgyX2FjY2Vzc190b2tlbiIsInRpZCI6Im5vdF9hdmFpbGFibGUiLCJhdWQiOiJFdGhvY2FFbnJpY2hlZFRyYW5zYWN0aW9ucyxFdGhvY2FEaWdpdGFsUmVjZWlwdHMiLCJuYmYiOjE3NjkwMjcwNTMsImdyYW50X3R5cGUiOiJjbGllbnRfY3JlZGVudGlhbHMiLCJleHAiOjE3NjkwMjc5NjMsImF1dGhUeXBlIjoiT0F1dGgyIiwib25lX3RpbWUiOiJmYWxzZSIsImlhdCI6MTc2OTAyNzA2MywianRpIjoiMjFmYWRlOTA4MzhmNzk2MTk4NGY2NGVlMGRmNmQ4MzciLCJjaWQiOiJqRHJROVF1d0Z5VzNkYjNoWWlDdVBYYklOeDFVSlR3ZGlWSnhQeDN1NDBiNmI2ODcifQ.UEWruWEt0YmtMapwacCDXaNGi3LOwRWXLqobnKvkFM2wMsqQBi7uP1qWLfNrxowELsXsr0gpuRYltG7_ufbZmPO3CqGZuV98ZjVgDdi-UKjyqBeaqXEpYCDUU72-I9nHSGQ-A2BLtU1C_5iA-t8NwYzUV1MAb04Ik278fOeE7Q_RJBr1GHp5EPmmzK5GYDS8IfyO_DxA3ZBM2YCjIukZL5mRL4Q_jWZtED1DPOcZoax_BtZuFCy_LoI6pX5S5qgj-IK3v2F0aqeCkNOs5QzEal7PR03a1cIjcI5eh40bclObArDUVWCMO1eufopZX-GvT4pUUqHksjXc3SamLAw_fg",
				"contentType": "MERCHANT_DETAILS",
				"expiresOn": "2026-01-21T20:39:23+00:00"
			}
		}
	]
}
```

[Back to top](https://developer.mastercard.com/consumer-clarity/documentation/testing/test-cases-first-party-trust/index.md#test-cases)

## Next Steps {#next-steps}

* [Testing](https://developer.mastercard.com/consumer-clarity/documentation/testing/index.md) shows you where to find other types of test cases that you can run.
* [API Reference](https://developer.mastercard.com/consumer-clarity/documentation/api-reference/index.md#apis) provides details about all of the fields and values in the Consumer Clarity API.
* See [Code and Formats](https://developer.mastercard.com/consumer-clarity/documentation/code-and-formats/index.md) for detailed information about error response handling.