# Parameters
source: https://developer.mastercard.com/unified-installments/documentation/parameters/index.md

This section provides high-level details about each of the elements mentioned as a part of the Merchant Installments Participation API specification in the API Reference section.

## Request Parameters {#request-parameters}

### MerchantParticipation {#merchantparticipation}

|     **Name**      |                                                          **Description**                                                          | **Type** |
|-------------------|-----------------------------------------------------------------------------------------------------------------------------------|----------|
| card_product_code | This is the card product code. API will return the list of merchants who have either opted in or opted out for this card product. | string   |
| offset            | The number of items you need in the start of the list to be offset from.                                                          | Integer  |
| limit             | The number of items you asked the list to be limited to.                                                                          | Integer  |

## Response Parameters {#response-parameters}

### MerchantParticipation {#merchantparticipation-1}

| **Name**  |                              **Description**                              |                                                       **Type**                                                        |
|-----------|---------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------|
| count     | The number of items in this batch (the size of the item array).           | integer                                                                                                               |
| offset    | The number of items you asked at the start of the list to be offset from. | integer                                                                                                               |
| limit     | The number of items you asked the list to be limited to.                  | integer                                                                                                               |
| total     | The total number of items in the collection.                              | integer                                                                                                               |
| merchants | The number of items in this batch (the size of the item array).           | array of [Merchant](https://developer.mastercard.com/unified-installments/documentation/parameters/index.md#merchant) |

### Merchant {#merchant}

|          **Name**           |                                                  **Description**                                                   |                                                          **Type**                                                           |
|-----------------------------|--------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|
| customerId                  | The primary key to identify a unique company or merchant, assigned by Mastercard.                                  | integer                                                                                                                     |
| duns                        | A unique identifier assigned by Dun and Bradstreet is used to identify a business.                                 | string                                                                                                                      |
| acceptorIds                 | A value assigned by Mastercard for transaction data integrity purposes                                             | array of strings                                                                                                            |
| companyName                 | Legally registered name of the merchant.                                                                           | string                                                                                                                      |
| dbaName                     | The trade name is used by a merchant to conduct business, and is known to the consumer.                            | string                                                                                                                      |
| customerReferenceUrlAddress | The URL of the merchant supplied to the acquirer.                                                                  | string                                                                                                                      |
| countryCode                 | Legally registered country code. Refer to (<https://www.iso.org/obp/ui/#search>) for ISO 3166 alpha 3 code values. | string                                                                                                                      |
| lastUpdateDatetime          | Time, when this record is last updated, this field will be as per ISO8601 and RFC 3339.                            | string                                                                                                                      |
| wallets                     | The API will return the list of wallet name, wallet acceptance, and wallet merchant ID.                            | array of [Wallet](https://developer.mastercard.com/unified-installments/documentation/parameters/index.md#wallet)           |
| products                    | List of card product objects                                                                                       | array of [CardProduct](https://developer.mastercard.com/unified-installments/documentation/parameters/index.md#cardproduct) |
| address                     | A object representing a merchant address                                                                           | [Address](https://developer.mastercard.com/unified-installments/documentation/parameters/index.md#address)                  |

### Wallet {#wallet}

|     **Name**     |                         **Description**                         | **Type** |
|------------------|-----------------------------------------------------------------|----------|
| walletName       | Wallet provider that has a relationship with the given merchant | string   |
| walletAcceptance | Wallet acceptance for the given wallet provider                 | string   |
| walletMerchantId | Merchant identifier as defined by the wallet provider           | string   |

### CardProduct {#cardproduct}

|  **Name**   |                    **Description**                    | **Type** |
|-------------|-------------------------------------------------------|----------|
| productCode | Codes of the products such as ETA - ETG, SPP, and SPS | string   |
| optIn       | Merchant opt-in or opt-out preference                 | string   |

### Address {#address}

|   **Name**   |                                                  **Description**                                                  | **Type** |
|--------------|-------------------------------------------------------------------------------------------------------------------|----------|
| addressLine1 | Legally registered address of the merchant                                                                        | string   |
| addressLine2 | Second address                                                                                                    | string   |
| addressLine3 | Third address line                                                                                                | string   |
| city         | Legally registered address city.                                                                                  | string   |
| state        | Legally registered address state or province. Refer to (<https://www.iso.org/obp/ui/#search>) for ISO 3166-2 code | string   |
| postalCode   | Legally registered address postal code.                                                                           | string   |

**Example API Response**

```json

{
  "count": 2,
  "offset": 1,
  "limit": 2,
  "total": 5,
  "merchants": [
    {
      "customerId": 9870152892,
      "duns": 879847416,
      "acceptorIds": [
        54331,
        123456
      ],
      "companyName": "Wallmart",
      "dbaName": "ACME",
      "companyUrl": "www.momentum-bike.com",
      "country": "USA",
      "postalCode": 99202,
      "wallets": [
        {
          "walletName": "Apple Pay",
          "walletAcceptance": "Y",
          "walletMerchantId": 235346356234
        },
        {
          "walletName": "Google Pay",
          "walletAcceptance": "N",
          "walletMerchantId": 125346356236
        }
      ],
      "address": {
        "addressLineOne": "600 WEST",
        "addressLineTwo": "SECTOR 5",
        "addressLineThree": "SUITE 775",
        "city": "Chicago",
        "state": "MO",
        "postalCode": 85001
      },
      "products": [
        {
          "productCode": "SPS",
          "optIn": "N"
        },
        {
          "productCode": "ETA",
          "optIn": "Y"
        }
      ],
      "lastUpdateDatetime": "2020-07-16T19:20+01:00"
    }
  ]
}
```

