# Manage transaction reports test cases
source: https://developer.mastercard.com/business-payment-controls/documentation/testing/transaction-reports/index.md

### Test data: Create an Authorization Report {#test-data-create-an-authorization-report}

**POST**/authorization-reports

#### Positive sample response {#positive-sample-response}

Success: Authorization Report created

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL"
}
```

#### Negative sample response {#negative-sample-response}

Fail: Unauthorized user

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "user.not.authorized",
          "Description": "User is not authorized to either create/view reports",
          "Recoverable": false,
          "Details": "User is missing the required permission to create/view reports"
        }
      ]
    }
  ]
}
```

### Test data: Get the status of an Authorization Report {#test-data-get-the-status-of-an-authorization-report}

**GET**/authorization-reports

#### Positive sample response {#positive-sample-response-1}

Success: Authorization Report status retrieved

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL",
  "recordCount": 6,
  "dataLimitExceeded": false
}
```

#### Negative sample response {#negative-sample-response-1}

Fail: Pagination parameter value is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "offset.invalid",
          "Description": "Pagination Offset value is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Get Authorization Report Status By GUID {#test-data-get-authorization-report-status-by-guid}

**GET**/authorization-reports/{guid}

#### Positive sample response {#positive-sample-response-2}

Success: Authorization Report retrieved by GUID

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL",
  "recordCount": 6,
  "dataLimitExceeded": false
}
```

#### Negative sample response {#negative-sample-response-2}

Fail: Report GUID is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "reportGuid.invalid",
          "Description": "Report GUID is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Fetch Authorization Report data {#test-data-fetch-authorization-report-data}

**GET**/authorization-reports/{guid}/data

#### Positive sample response {#positive-sample-response-3}

Success: Authorization Report data retrieved

HTTP code `2xx`

**Payload**

```json
{
  "subject": "PAYMENT_AUTHORIZATION",
  "content": {
    "processor": {
      "issuerID": 1,
      "result": 0,
      "resultDescription": "Approval",
      "appliedDateTime": "2018-12-17T11:09:42.10+01:00",
      "responseCode": "00",
      "onBehalfResult": "L",
      "onBehalfService": "33"
    },
    "realPaymentCard": {
      "number": "XXXXXXXXXXXX3878",
      "expiry": "2007",
      "status": "ACTIVE"
    },
    "virtualPaymentCard": {
      "number": "XXXXXXXXXXXX9117",
      "expiry": "2007",
      "status": "ACTIVE"
    },
    "acceptor": {
      "name": "ABC Supplier",
      "cityName": "City Name",
      "subDivisionCode": "353",
      "terminalId": "abc123xy",
      "id": "123456123456432",
      "merchantCategoryCode": "1644",
      "merchantCategoryCodeDescription": "Financial Position Detail",
      "environment": "ATM",
      "localDate": "220115",
      "localTime": "100100",
      "retrievalReferenceNumber": "123456123456",
      "posCountryCode": "840",
      "posCountryCodeDescription": "UNITED STATES",
      "amount": {
        "amount": 500,
        "currencyCode": 978,
        "currencyCodeAlphabetic": "EUR"
      }
    },
    "cardHolderAmount": {
      "amount": 500,
      "currencyCode": 978,
      "currencyCodeAlphabetic": "EUR",
      "effectOnBalance": 100
    },
    "transactionInformation": {
      "acquirerInstitutionIdCode": 123456,
      "forwardingInstitutionIdCode": 322222,
      "conversionRateCardholderBilling": 22,
      "processingCode": "200000",
      "authCode": "111111",
      "dateTime": "2020-07-16T19:20:42.10+01:00",
      "mtIdType": "0100",
      "type": "0",
      "subType": "1",
      "environment": "ATM",
      "issuerResponse": "00",
      "avsResponseCode": "0",
      "systemTraceAuditNumber": "000071",
      "isMatched": true,
      "partialApprovedAmount": 500,
      "settlementAmount": {
        "amount": 500,
        "currencyCode": 978,
        "currencyCodeAlphabetic": "EUR"
      },
      "reversal": {
        "transactionId": 12345,
        "type": "0",
        "replacementTransactionAmount": 500,
        "replacementCardholderAmount": 500,
        "appliedDateTime": "2020-07-16T11:09:42.00+00:00"
      },
      "authorizationTransactionID": 182447,
      "posEntryMode": "810"
    },
    "fundingSource": {
      "alias": "Alias"
    }
  }
}
```

#### Negative sample response {#negative-sample-response-3}

Fail: Report GUID is missing

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "reportGuid.not found",
          "Description": "Report GUID is not found",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Create a Clearing Report {#test-data-create-a-clearing-report}

**POST**/clearing-reports

#### Positive sample response {#positive-sample-response}

Success: Clearing Report created

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL"
}
```

#### Negative sample response {#negative-sample-response}

Fail: Account number pattern is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "account.number.pattern.invalid",
          "Description": "Account Number pattern is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Get the status of a Clearing Report {#test-data-get-the-status-of-a-clearing-report}

**GET**/clearing-reports

#### Positive sample response {#positive-sample-response-1}

Success: Clearing Report status retrieved

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL",
  "recordCount": 6,
  "dataLimitExceeded": false
}
```

#### Negative sample response {#negative-sample-response-1}

Fail: Pagination parameter value is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "offset.invalid",
          "Description": "Pagination Offset value is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Get Clearing Report Status By GUID {#test-data-get-clearing-report-status-by-guid}

**GET**/clearing-reports/{guid}

#### Positive sample response {#positive-sample-response-2}

Success: Clearing Report retrieved by GUID

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL",
  "recordCount": 6,
  "dataLimitExceeded": false
}
```

#### Negative sample response {#negative-sample-response-2}

Fail: Report GUID is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "reportGuid.invalid",
          "Description": "Report GUID is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Fetch Clearing Report data {#test-data-fetch-clearing-report-data}

**GET**/clearing-reports/{guid}/data

#### Positive sample response {#positive-sample-response-3}

Success: Clearing Report data retrieved

HTTP code `2xx`

**Payload**

```json
{
  "subject": "PAYMENT_AUTHORIZATION",
  "content": {
    "processor": {
      "issuerID": 1,
      "result": 0,
      "resultDescription": "Approval",
      "appliedDateTime": "2018-12-17T11:09:42.10+01:00",
      "responseCode": "00",
      "onBehalfResult": "L",
      "onBehalfService": "33"
    },
    "realPaymentCard": {
      "number": "XXXXXXXXXXXX3878",
      "expiry": "2007",
      "status": "ACTIVE"
    },
    "virtualPaymentCard": {
      "number": "XXXXXXXXXXXX9117",
      "expiry": "2007",
      "status": "ACTIVE"
    },
    "acceptor": {
      "name": "ABC Supplier",
      "cityName": "City Name",
      "subDivisionCode": "353",
      "terminalId": "abc123xy",
      "id": "123456123456432",
      "merchantCategoryCode": "1644",
      "merchantCategoryCodeDescription": "Financial Position Detail",
      "environment": "ATM",
      "localDate": "220115",
      "localTime": "100100",
      "retrievalReferenceNumber": "123456123456",
      "posCountryCode": "840",
      "posCountryCodeDescription": "UNITED STATES",
      "amount": {
        "amount": 500,
        "currencyCode": 978,
        "currencyCodeAlphabetic": "EUR"
      }
    },
    "cardHolderAmount": {
      "amount": 500,
      "currencyCode": 978,
      "currencyCodeAlphabetic": "EUR",
      "effectOnBalance": 100
    },
    "transactionInformation": {
      "acquirerInstitutionIdCode": 123456,
      "forwardingInstitutionIdCode": 322222,
      "conversionRateCardholderBilling": 22,
      "processingCode": "200000",
      "authCode": "111111",
      "dateTime": "2020-07-16T19:20:42.10+01:00",
      "mtIdType": "0100",
      "type": "0",
      "subType": "1",
      "environment": "ATM",
      "issuerResponse": "00",
      "avsResponseCode": "0",
      "systemTraceAuditNumber": "000071",
      "isMatched": true,
      "partialApprovedAmount": 500,
      "settlementAmount": {
        "amount": 500,
        "currencyCode": 978,
        "currencyCodeAlphabetic": "EUR"
      },
      "reversal": {
        "transactionId": 12345,
        "type": "0",
        "replacementTransactionAmount": 500,
        "replacementCardholderAmount": 500,
        "appliedDateTime": "2020-07-16T11:09:42.00+00:00"
      },
      "authorizationTransactionID": 182447,
      "posEntryMode": "810"
    },
    "fundingSource": {
      "alias": "Alias"
    }
  }
}
```

#### Negative sample response {#negative-sample-response-3}

Fail: Report GUID is missing

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "reportGuid.not found",
          "Description": "Report GUID is not found",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Create a Clearing Summary Report {#test-data-create-a-clearing-summary-report}

**POST**/clearing-summary-reports

#### Positive sample response {#positive-sample-response}

Success: Clearing Summary Report created

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL"
}
```

#### Negative sample response {#negative-sample-response}

Fail: Account number pattern is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "account.number.pattern.invalid",
          "Description": "Account Number pattern is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Get the status of a Clearing Summary Report {#test-data-get-the-status-of-a-clearing-summary-report}

**GET**/clearing-summary-reports

#### Positive sample response {#positive-sample-response-1}

Success: Clearing Summary Report status retrieved

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL",
  "recordCount": 6,
  "dataLimitExceeded": false
}
```

#### Negative sample response {#negative-sample-response-1}

Fail: Pagination parameter value is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "offset.invalid",
          "Description": "Pagination Offset value is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Get Clearing Summary Report Status By GUID {#test-data-get-clearing-summary-report-status-by-guid}

**GET**/clearing-summary-reports/{guid}

#### Positive sample response {#positive-sample-response-2}

Success: Clearing Summary Report retrieved by GUID

HTTP code `2xx`

**Payload**

```json
{
  "accountNumber": "XXXXXXXXXXXX8594",
  "accountGuid": "SENTTYE1FEC5539C2E44B1CA7FA4696444802F4EB34D38B90DC005E99947420BC1AE8315973849922",
  "dateTimeRangeFrom": "2020-07-16T19:20:00.10+01:00",
  "dateTimeRangeTo": "2020-08-16T19:20:42.10+01:00",
  "reportGuid": "REPO0ENT92fcefdfc144c5f5098ca57c3026e6295688e2061ccb9facdc 310bbcdc5972d11644095460RTGUID",
  "createDate": "2020-07-16T19:20:42.10+01:00",
  "status": "COMPLETED",
  "transactionType": "ALL",
  "recordCount": 6,
  "dataLimitExceeded": false
}
```

#### Negative sample response {#negative-sample-response-2}

Fail: Report GUID is invalid

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "reportGuid.invalid",
          "Description": "Report GUID is invalid",
          "Recoverable": false
        }
      ]
    }
  ]
}
```

### Test data: Fetch Clearing Summary Report data {#test-data-fetch-clearing-summary-report-data}

**GET**/clearing-summary-reports/{guid}/data

### Positive sample response {#positive-sample-response-3}

Success: Clearing Summary Report data retrieved

HTTP code `2xx`

**Payload**

```json
{
  "subject": "PAYMENT_AUTHORIZATION",
  "content": {
    "processor": {
      "issuerID": 1,
      "result": 0,
      "resultDescription": "Approval",
      "appliedDateTime": "2018-12-17T11:09:42.10+01:00",
      "responseCode": "00",
      "onBehalfResult": "L",
      "onBehalfService": "33"
    },
    "realPaymentCard": {
      "number": "XXXXXXXXXXXX3878",
      "expiry": "2007",
      "status": "ACTIVE"
    },
    "virtualPaymentCard": {
      "number": "XXXXXXXXXXXX9117",
      "expiry": "2007",
      "status": "ACTIVE"
    },
    "acceptor": {
      "name": "ABC Supplier",
      "cityName": "City Name",
      "subDivisionCode": "353",
      "terminalId": "abc123xy",
      "id": "123456123456432",
      "merchantCategoryCode": "1644",
      "merchantCategoryCodeDescription": "Financial Position Detail",
      "environment": "ATM",
      "localDate": "220115",
      "localTime": "100100",
      "retrievalReferenceNumber": "123456123456",
      "posCountryCode": "840",
      "posCountryCodeDescription": "UNITED STATES",
      "amount": {
        "amount": 500,
        "currencyCode": 978,
        "currencyCodeAlphabetic": "EUR"
      }
    },
    "cardHolderAmount": {
      "amount": 500,
      "currencyCode": 978,
      "currencyCodeAlphabetic": "EUR",
      "effectOnBalance": 100
    },
    "transactionInformation": {
      "acquirerInstitutionIdCode": 123456,
      "forwardingInstitutionIdCode": 322222,
      "conversionRateCardholderBilling": 22,
      "processingCode": "200000",
      "authCode": "111111",
      "dateTime": "2020-07-16T19:20:42.10+01:00",
      "mtIdType": "0100",
      "type": "0",
      "subType": "1",
      "environment": "ATM",
      "issuerResponse": "00",
      "avsResponseCode": "0",
      "systemTraceAuditNumber": "000071",
      "isMatched": true,
      "partialApprovedAmount": 500,
      "settlementAmount": {
        "amount": 500,
        "currencyCode": 978,
        "currencyCodeAlphabetic": "EUR"
      },
      "reversal": {
        "transactionId": 12345,
        "type": "0",
        "replacementTransactionAmount": 500,
        "replacementCardholderAmount": 500,
        "appliedDateTime": "2020-07-16T11:09:42.00+00:00"
      },
      "authorizationTransactionID": 182447,
      "posEntryMode": "810"
    },
    "fundingSource": {
      "alias": "Alias"
    }
  }
}
```

#### Negative sample response {#negative-sample-response-3}

Fail: Report GUID is missing

HTTP code `4xx`

**Payload**

```json
{
  "Errors": [
    {
      "Error": [
        {
          "Source": "accounts-reporting-service",
          "ReasonCode": "reportGuid.not found",
          "Description": "Report GUID is not found",
          "Recoverable": false
        }
      ]
    }
  ]
}
```