# Parameters
source: https://developer.mastercard.com/doconomy-aland-index/documentation/donotuse-parameters/index.md

## Transaction Footprints {#transaction-footprints}

| Method |             Endpoint             |
|--------|----------------------------------|
| POST   | /doconomy/transaction-footprints |

### Request parameters {#request-parameters}

|     Name      |  Type  |                                                                                                                                           Description                                                                                                                                           | Required |
|---------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| transactionId | string | A unique id associated with each payment transaction.                                                                                                                                                                                                                                           | yes      |
| mcc           | string | Merchant category code of a payment transaction that uniquely defines a merchant business. It must be one of the values defined in the [/supported-merchant-categories](https://developer.mastercard.com/doconomy-aland-index/documentation/parameters/index.md#supported-merchant-categories). | yes      |
| amount        | object | See [Amount](https://developer.mastercard.com/doconomy-aland-index/documentation/parameters/index.md#amount)                                                                                                                                                                                    | yes      |

#### Amount {#amount}

|     Name     |  Type  |                                                                                                                             Description                                                                                                                              | Required |
|--------------|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| value        | number | Actual amount of a payment transaction.                                                                                                                                                                                                                              | yes      |
| currencyCode | string | Currency code as per [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). It must be one of the values defined in the [/supported-merchant-categories](https://developer.mastercard.com/doconomy-aland-index/documentation/parameters/index.md#supported-currencies). | yes      |

### Sample Request {#sample-request}

```json
{
    "transactions": [
        {
            "transactionId": "386d8182-f753-412c-bd8b-762dae93a687",
            "mcc": "3000",
            "amount": {
                "value": 150,
                "currencyCode": "EUR"
            }
        }
    ]
}
```

### Response parameters {#response-parameters}

A successful request returns the HTTP 200 Success status code and a JSON response body.

|          Name          |  Type  |                                                                                  Description                                                                                  | Required |
|------------------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|
| transactionId          | string | A unique id associated with a transaction (same as in request).                                                                                                               | yes      |
| carbonEmissionInGrams  | number | The transaction's CO2 emission in grams.                                                                                                                                      | no       |
| carbonEmissionInOunces | number | The transaction's CO2 emission in ounces.                                                                                                                                     | no       |
| carbonSocialCost       | object | Transaction's social cost of carbon, see [CarbonSocialCost](https://developer.mastercard.com/doconomy-aland-index/documentation/parameters/index.md#carbonsocialcost).        | no       |
| waterUseInCubicMeters  | number | The transaction's water use in cubic meters.                                                                                                                                  | no       |
| waterUseInGallons      | number | The transaction's water use in gallons.                                                                                                                                       | no       |
| waterUseSocialCost     | object | Transaction's social cost of water use, see [WaterUseSocialCost](https://developer.mastercard.com/doconomy-aland-index/documentation/parameters/index.md#waterusesocialcost). | no       |

#### CarbonSocialCost {#carbonsocialcost}

|     Name     |  Type  |                               Description                                | Required |
|--------------|--------|--------------------------------------------------------------------------|----------|
| value        | number | Actual value of CarbonSocialCost.                                        | yes      |
| currencyCode | string | Currency code as per [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). | yes      |

#### WaterUseSocialCost {#waterusesocialcost}

|     Name     |  Type  |                               Description                                | Required |
|--------------|--------|--------------------------------------------------------------------------|----------|
| value        | number | Actual value of WaterUseSocialCost.                                      | yes      |
| currencyCode | string | Currency code as per [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). | yes      |

### Sample Response {#sample-response}

```json
{
  "transactionFootPrints": [
    {
      "transactionId": "386d8182-f753-412c-bd8b-762dae93a687",
      "carbonEmissionInGrams": 79.50,
      "carbonEmissionInOunces": 2.80,
      "carbonSocialCost": {
        "currencyCode": "EUR",
        "value": 19.50
      },
      "waterUseInCubicMeters": 94.50,
      "waterUseInGallons": 24964.26,
      "waterUseSocialCost": {
        "currencyCode": "EUR",
        "value": 34.50
      }
    }
  ]
}
```

<br />

<br />

## Supported Currencies {#supported-currencies}

| Method |            Endpoint            |
|--------|--------------------------------|
| GET    | /doconomy/supported-currencies |

### Response parameters {#response-parameters}

|    Name    |                                                          Type                                                           |          Description          | Required |
|------------|-------------------------------------------------------------------------------------------------------------------------|-------------------------------|----------|
| currencies | array, See [Currency](https://developer.mastercard.com/doconomy-aland-index/documentation/parameters/index.md#currency) | List of supported currencies. | yes      |

#### Currency {#currency}

|     Name     |  Type  |                               Description                                | Required |
|--------------|--------|--------------------------------------------------------------------------|----------|
| currencyCode | string | Currency code as per [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). | yes      |

### Sample Response {#sample-response}

```json
{
  "currencies": [
    {
      "currencyCode": "USD"
    },
    {
      "currencyCode": "EUR"
    },
    {
      "currencyCode": "GBP"
    },
    {
      "currencyCode": "SEK"
    }
  ]
}
```

<br />

<br />

## Supported Merchant Categories {#supported-merchant-categories}

Tip: Merchant Category Code (MCC) is an assigned four-digit number that properly identifies a merchant's primary business based on annual sales volume. Customers must include a valid MCC in all authorization and clearing messages.

| Method |                Endpoint                 |
|--------|-----------------------------------------|
| GET    | /doconomy/supported-merchant-categories |

### Response parameters {#response-parameters}

|        Name        |                                                                  Type                                                                   |              Description               | Required |
|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|----------|
| merchantCategories | array, See [Merchantcategory](https://developer.mastercard.com/doconomy-aland-index/documentation/parameters/index.md#merchantcategory) | List of supported merchant categories. | yes      |

#### Merchantcategory {#merchantcategory}

| Name |  Type  |                                        Description                                         | Required |
|------|--------|--------------------------------------------------------------------------------------------|----------|
| mcc  | string | Merchant category code of a payment transaction that uniquely defines a merchant business. | yes      |

### Sample Response {#sample-response}

```json
{
  "merchantCategories": [
    {
      "mcc": "3860"
    },
    {
      "mcc": "3861"
    },
    {
      "mcc": "3620"
    },
    {
      "mcc": "3862"
    },
    {
      "mcc": "3621"
    },
    {
      "mcc": "3863"
    },
    {
      "mcc": "5800"
    },
    {
      "mcc": "3622"
    },
    {
      "mcc": "3864"
    },
    {
      "mcc": "5801"
    },
    {
      "mcc": "5858"
    },
    {
      "mcc": "5859"
    },
    {
      "mcc": "5871"
    }
  ]
}
```