# Testing
source: https://developer.mastercard.com/identity-insights-for-transactions/documentation/testing/index.md

This section provides the testing guides for your API integration in the sandbox environment.

## Test Cases {#test-cases}

This tutorial explains different test cases to verify positive and negative scenarios for the Identity Insights for
Transactions (IIT) API endpoints.  

| **Test Case ID** |        **Test Type**         |     **Test Type Details**     |   **Input**   | **Output** |                                   **Test Success Criteria**                                   |
|------------------|------------------------------|-------------------------------|---------------|------------|-----------------------------------------------------------------------------------------------|
| 1                | Customer input validation    | Individual \& Device Insights | Customer Data | Variable   | All inputs are correctly formatted, 200 response is returned and match customer expectations. |
| 2                | Simulating 400 client errors | Omitting required field       | Customer Data | Variable   | Provided data input returns expected output, simulating the desired error message.            |
| 3                | Simulating 400 client errors | Incorrect length/format       | Customer Data | Variable   | Provided data input returns expected output, simulating the desired error message.            |

#### Use case fields criteria {#use-case-fields-criteria}

Refer to the [Request Body Model](https://developer.mastercard.com/identity-insights-for-transactions/documentation/api-reference/index.md) .  

#### The following are the sample request, and responses for the Test cases validations for both positive and negative test scenarios. \*\* {#the-following-are-the-sample-request-and-responses-for-the-test-cases-validations-for-both-positive-and-negative-test-scenarios-brbr}

#### Introduction {#introduction}

The end-point allows the client to obtain insights for all possible transactions regardless of card brand .  

#### Pre-requisites {#pre-requisites}

Refer to the [Obtain insights for all transactions](https://developer.mastercard.com/identity-insights-for-transactions/documentation/use-cases/use-cases-2/index.md) details.  

#### Sandbox test data for the end-point {#sandbox-test-data-for-the-end-point}

Sandbox data is consistent across all users.   

#### Sample Request and Response with required fields {#sample-request-and-response-with-required-fields}

**Request**

```java
{
  "purchaseDate":"20220721173228",
  "purchaseAmount":12345,
  "purchaseCurrencyExponent":"2",
  "purchaseCurrency":840,
  "accountDetails":{
  "accountNumber":30000000000004,
  "cardExpiryDate":"2203"
  },
  "merchantName":"Acme Inc",
  "merchantCountryCode":"840",
  "mcc":"0001",
  "ipAddress":"1.1.1.160",
  "userAgent":"Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 7.0; InfoPath.3; .NET CLR 3.1.40767; Trident/6.0; en-IN)",
  "cardHolderName":"Waidong L Syrws",
  "endCustomerRefId": "123"
  }
```

**Response**

```java
{
  "id": "819bedc4-1a43-435b-8f06-747fa653092c",
  "deviceInsights": {
  "deviceInfo": {
  "browser": "IE",
  "platform": "Windows",
  "deviceType": "Generic"
  }
  },
  "individualInsights": {
  "primaryEmail": {},
  "ip": {
  "billingAddressDistance": 240,
  "lastSeenDays": 234,
  "connectionType": "cable-dsl",
  "shippingAddressDistance": 240,
  "providerDetails": {
  "country": "australia",
  "ipCarrier": "cloudflare",
  "city": "research (melbourne)",
  "state": "victoria"
  },
  "isProxy": true,
  "proxyRiskClass": "low"
  }
  "shippingAddress": {
  "validityLevel": "missing_address"
  },
  "billingAddress": {
  "validityLevel": "missing_address"
  },
  "scores": {
  "ipRisk": {
  "score": 0.935
  },
  "identityRisk": {
  "score": 61,
  "reasonCode": "RN"
  }
  },
  "paymentCard": {
  "cardHolderNamefirstSeenDays": 0,
  "cardHolderNameVelocity": 0
  }
  }
  }
```

#### Sample Request and Response with required and optional fields {#sample-request-and-response-with-required-and-optional-fields}

**Request**

```java

{
  "purchaseDate":"20220721173228",
  "purchaseAmount":12345,
  "purchaseCurrencyExponent":"2",
  "purchaseCurrency":840,
  "accountDetails":{
  "accountNumber":30000000000004,
  "cardExpiryDate":"2203",
  "cardLast4":"4113"
  },
  "merchantName":"Acme Inc",
  "merchantCountryCode":"840",
  "mcc":"0001",
  "ipAddress":"1.1.1.160",
  "secondaryName":"Waidong L Syrws",
  "userAgent":"Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 7.0; InfoPath.3; .NET CLR 3.1.40767; Trident/6.0; en-IN)",
  "acquirerMerchantId":"acquirerMerchantId",
  "acquirerBin":"acquirerBin",
  "cardHolderName":"Waidong L Syrws",
  "primaryEmail":"john@mastercard.com",
  "secondaryEmail":"ted@mastercard.com",
  "mobilePhone":{
  "cc":"1",
  "subscriber":"4143978691"
  },
  "billingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "shippingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "homePhone":{
  "cc":"1",
  "subscriber":"314397869122"
  },
  "workPhone":{
  "cc":"1",
  "subscriber":"2143978691"
  },
  "timeZone":"123",
  "screenWidth":"1792",
  "screenHeight":"828",
  "language":"zh-tw",
  "colorDepth":"98",
  "endCustomerRefId": "noflag"
  }
```

**Response**

```java
{
  "id": "1b2cb8d4-caa2-433d-a201-d858b10ffd92",
  "deviceInsights": {
  "deviceInfo": {
  "browser": "IE",
  "platform": "Windows",
  "deviceType": "Generic"
  },
  "deviceIpTzDifference": 42,
  "deviceEmailPaymentFirstSeenDays": 11,
  "deviceIpPaymentFirstSeenDays": 11,
  "deviceIpFirstSeenDays": 39,
  "deviceIpEmailFirstSeenDays": 39,
  "deviceRisk": {
  "score": 0.996
  }
  },
  "individualInsights": {
  "primaryEmail": {
  "firstSeenDays": 3751,
  "lastSeenDays": 3751,
  "matchToName": "no-match",
  "domainCreationDate": "1994-07-27",
  "valid": true,
  "emailRisk": {
  "score": 0.019
  },
  "mailboxVelocity": 0,
  "isDisposable": false
  },
  "ip": {
  "billingAddressDistance": 240,
  "lastSeenDays": 234,
  "connectionType": "cable-dsl",
  "shippingAddressDistance": 240,
  "providerDetails": {
  "country": "australia",
  "ipCarrier": "cloudflare",
  "city": "research (melbourne)",
  "state": "victoria"
  },
  "isProxy": true,
  "proxyRiskClass": "low"
  }
  "homePhone": {
  "valid": false
  },
  "mobilePhone": {
  "matchToName": "not-found",
  "phoneNumberCarrier": "T-Mobile Usa",
  "lineType": "mobile",
  "valid": true
  },
  "shippingAddress": {
  "validityLevel": "valid_to_country"
  },
  "billingAddress": {
  "validityLevel": "valid_to_country"
  },
  "workPhone": {
  "matchToName": "no-match",
  "phoneNumberCarrier": "Metropcs Wireless Inc.",
  "lineType": "mobile",
  "valid": true
  },
  "scores": {
  "ipRisk": {
  "score": 0.935
  },
  "identityRisk": {
  "score": 212,
  "reasonCode": "JF"
  }
  },
  "paymentCard": {
  "cardHolderNamefirstSeenDays": 0,
  "cardHolderNameVelocity": 0
  }
  }
  }
```

#### Introduction {#introduction}

The end-point allows the client to obtain error insights for all card transactions for invalid or missing fields.   

#### Pre-requisites {#pre-requisites}

Refer to the [Code and format section](https://developer.mastercard.com/identity-insights-for-transactions/documentation/code-and-formats/index.md) for details.  

#### Sandbox test data for the end-point {#sandbox-test-data-for-the-end-point}

Sandbox error data is consistent across all users, and the different use cases are different for all card
transactions.   

#### EndCustomerRefId is required {#endcustomerrefid-is-required}

**Request**

```java

{
  "purchaseDate":"20220721173228",
  "purchaseAmount":12345,
  "purchaseCurrencyExponent":"2",
  "purchaseCurrency":840,
  "accountDetails":{
  "accountNumber":5005303006786299,
  "cardExpiryDate":"2203",
  "cardLast4":"4113"
  },
  "merchantName":"Acme Inc",
  "merchantCountryCode":"840",
  "mcc":"0001",
  "ipAddress":"1.1.1.160",
  "secondaryName":"Waidong L Syrws",
  "userAgent":"Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 7.0; InfoPath.3; .NET CLR 3.1.40767; Trident/6.0; en-IN)",
  "acquirerMerchantId":"acquirerMerchantId",
  "acquirerBin":"acquirerBin",
  "cardHolderName":"Waidong L Syrws",
  "primaryEmail":"john@mastercard.com",
  "secondaryEmail":"ted@mastercard.com",
  "mobilePhone":{
  "cc":"1",
  "subscriber":"4143978691"
  },
  "billingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "shippingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "homePhone":{
  "cc":"1",
  "subscriber":"314397869122"
  },
  "workPhone":{
  "cc":"1",
  "subscriber":"2143978691"
  },
  "timeZone":"123",
  "screenWidth":"1792",
  "screenHeight":"828",
  "language":"zh-tw",
  "colorDepth":"98"
  }
```

**Response**

```java
Error :
  {
  "Errors": {
  "Error": [
  {
  "Source": "IIT",
  "ReasonCode": "VALIDATION_ERROR",
  "Description": "endCustomerRefId is required",
  "Recoverable": false,
  "Details": "endCustomerRefId"
  }
  ]
  }
  }
```

#### Introduction {#introduction}

The end-point allows the client to obtain error insights for all card transactions for unauthorized request.   

#### Pre-requisites {#pre-requisites}

Refer to the [Code and format section](https://developer.mastercard.com/identity-insights-for-transactions/documentation/code-and-formats/index.md) for details.  

#### Sandbox test data for the end-point {#sandbox-test-data-for-the-end-point}

Sandbox error data is consistent across all users, and the different use cases are different for all card
transactions.   

#### Unauthorized - Access granted Scenario {#unauthorized---access-granted-scenario}

**Request**

```java
{
  "purchaseDate":"20220721173228",
  "purchaseAmount":12345,
  "purchaseCurrencyExponent":"2",
  "purchaseCurrency":840,
  "accountDetails":{
  "accountNumber":null,
  "cardExpiryDate":"2203",
  "cardLast4":null
  },
  "merchantName":"Acme Inc",
  "merchantCountryCode":"840",
  "mcc":"0001",
  "ipAddress":"1.1.1.160",
  "secondaryName":"Waidong L Syrws",
  "userAgent":"Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 7.0; InfoPath.3; .NET CLR 3.1.40767; Trident/6.0; en-IN)",
  "acquirerMerchantId":"acquirerMerchantId",
  "acquirerBin":"acquirerBin",
  "cardHolderName":"Waidong L Syrws",
  "primaryEmail":"john@mastercard.com",
  "secondaryEmail":"ted@mastercard.com",
  "mobilePhone":{
  "cc":"1",
  "subscriber":"4143978691"
  },
  "billingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "shippingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "homePhone":{
  "cc":"1",
  "subscriber":"314397869122"
  },
  "workPhone":{
  "cc":"1",
  "subscriber":"2143978691"
  },
  "timeZone":"123",
  "screenWidth":"1792",
  "screenHeight":"828",
  "language":"zh-tw",
  "colorDepth":"98"
  }
```

**Response**

```java
{

  "Errors":{
  "Error":[
  {
  "Source":"IIT",
  "ReasonCode":"UNAUTHORIZED",
  "Description":"Unauthorized Request",
  "Recoverable":false
  }
  ]
  }
  }
```

#### Introduction {#introduction}

The end-point allows the client to obtain error insights for all card transactions with transient system failure.   

#### Pre-requisites {#pre-requisites}

Refer to the [Code and format section](https://developer.mastercard.com/identity-insights-for-transactions/documentation/code-and-formats/index.md) for details.  

#### Sandbox test data for the end-point {#sandbox-test-data-for-the-end-point}

Sandbox error data is consistent across all users, and the different use cases are different for all card
transactions.   

#### Unable to get insights from Nudata and Ekata server. {#unable-to-get-insights-from-nudata-and-ekata-server}

**Request**

```java

{
  "purchaseDate":"20220721173228",
  "purchaseAmount":12345,
  "purchaseCurrencyExponent":"2",
  "purchaseCurrency":840,
  "accountDetails":{
  "accountNumber":5599991212121212,
  "cardLast4":"4402",
  "cardExpiryDate":"2203",
  "cardBin":"1234"
  },
  "merchantName":"Acme Inc",
  "merchantCountryCode":"840",
  "mcc":"0001",
  "ipAddress":"1.1.1.160",
  "secondaryName":"Waidong L Syrws",
  "userAgent":"Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 7.0; InfoPath.3; .NET CLR 3.1.40767; Trident/6.0; en-IN)",
  "acquirerMerchantId":"acquirerMerchantId",
  "acquirerBin":"acquirerBin",
  "cardHolderName":"Waidong L Syrws",
  "primaryEmail":"john@mastercard.com",
  "secondaryEmail":"ted@mastercard.com",
  "mobilePhone":{
  "cc":"1",
  "subscriber":"4143978691"
  },
  "billingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "shippingAddress":{
  "addressLine1":"912 Uclan Dr",
  "addressLine2":"Apt 34",
  "addressCity":"Houston",
  "addressState":"TX",
  "addressPostCode":"63124",
  "addressCountry":"840"
  },
  "homePhone":{
  "cc":"1",
  "subscriber":"314397869122"
  },
  "workPhone":{
  "cc":"1",
  "subscriber":"2143978691"
  },
  "timeZone":"123",
  "screenWidth":"1792",
  "screenHeight":"828",
  "language":"zh-tw",
  "colorDepth":"98"
  }
```

**Response**

```java

{
  "Errors":{
  "Error":[
  {
  "Source":"IIT",
  "ReasonCode":"Transient System Failure",
  "Description":"System failure",
  "Recoverable":true
  }
  ]
  }
  }
```