---
agentTools:
  projectIndex: https://partnerhubapi.stone.com.br/llms.txt
---

# Obter MCC

Lista os MCC's disponíveis para o lojista

> 🚧 Atenção ao consultar o MCC
>
> Para obter o MCC com CPF é necessário ter o [segmento](https://partnerhubapi.stone.com.br/reference/consulta-segmentos-cpf) e consultar juntamente com o CPF.
>
> Para CNPJ não inserir o segmento apenas o CNPJ para obter o MCC.

## Estrutura Principal do Response

| Campo     | Tipo      | Descrição                                                                             |
| :-------- | :-------- | :------------------------------------------------------------------------------------ |
| `success` | `boolean` | Indica se a requisição foi concluída com sucesso.                                     |
| `data`    | `object`  | Objeto que contém os dados da resposta, seja a lista de MCCs ou uma mensagem de erro. |

***

## Estrutura do Objeto `data`

| Campo   | Tipo     | Descrição                                                                                                                  |
| :------ | :------- | :------------------------------------------------------------------------------------------------------------------------- |
| `mccs`  | `array`  | Uma lista de objetos, cada um representando um **MCC (Merchant Category Code)**. Este campo é populado em caso de sucesso. |
| `error` | `string` | Contém uma mensagem de erro descritiva caso a requisição falhe (quando `success` for `false`).                             |

### Estrutura do Objeto `mccs` (dentro da lista)

| Campo | Tipo     | Descrição                                                                                     |
| :---- | :------- | :-------------------------------------------------------------------------------------------- |
| `mcc` | `number` | O código numérico de 4 dígitos do MCC, que classifica o ramo de atividade do estabelecimento. |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Partner Hub API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://partnerhub-sdx-external-api.stone.com.br"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/affiliates/mcc": {
      "get": {
        "summary": "Obter MCC",
        "description": "Lista os MCC's disponíveis para o lojista",
        "operationId": "get-mcc",
        "parameters": [
          {
            "name": "segment",
            "in": "query",
            "description": "Segmento do lojista",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "document",
            "in": "query",
            "description": "CNPJ do lojista",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "Token JWT decriptado",
            "schema": {
              "type": "string",
              "default": "Bearer Token_aqui"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"success\": true,\n  \"data\": {\n    \"mccs\": [\n      {\n        \"code\": 0\n      }\n    ],\n    \"error\": \"string\"\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "mccs": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "code": {
                                "type": "integer",
                                "example": 0,
                                "default": 0
                              }
                            }
                          }
                        },
                        "error": {
                          "type": "string",
                          "example": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "66fdc0f9b9c59e006159f051:687bdddc888a898d88c1e0c0"
}
```