# Consultar merchant

> Devolve o cadastro completo de um merchant da sua empresa pelo merchant_id: contato, endereço, termos e a referência do seu sistema.

Página: https://doc.rapidchargeback.com/canais/merchants/consultar-merchant/

Devolve o cadastro completo de um merchant da sua empresa. Para achar o `merchant_id`, use [Listar merchants](https://doc.rapidchargeback.com/canais/merchants/listar-merchants/) (inclusive pelo `merchant_ref`, o ID do vendedor no seu sistema).

## Endpoint

```
GET https://api.rapidchargeback.com/api/v1/merchants/:merchant_id
```

## Autenticação

```
Authorization: Basic base64(client_id:client_secret)
```

---

## Parâmetros de URL

| Param | Tipo | Descrição |
|---|---|---|
| `merchant_id` | string (UUID) | O `id` do merchant |

Esta rota não aceita query params: qualquer parâmetro na URL é recusado com `422 VALIDATION_ERROR` (`Unknown field: <nome>`).

---

## Exemplo de requisição

```bash
curl https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
```

---

## Resposta

### Sucesso

```
HTTP/1.1 200 OK
```

```json
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000001",
    "name": "Loja Exemplo",
    "merchant_ref": "PB-1001",
    "status": "active",
    "created_at": "2026-03-10T12:00:00.000Z",
    "updated_at": "2026-11-06T12:00:00.000Z",
    "store_name": "Loja Exemplo",
    "merchant_url": "https://lojaexemplo.com",
    "contact_phone": "+55 11 99999-0000",
    "email": "contato@lojaexemplo.com",
    "mcc": "5999",
    "description": null,
    "logo_url": null,
    "terms": null,
    "terms_url": "https://lojaexemplo.com/termos",
    "refund_policy": null,
    "refund_policy_url": "https://lojaexemplo.com/reembolso",
    "customer_service_instructions": null,
    "address_street": "Rua Exemplo",
    "address_number": "100",
    "address_city": "São Paulo",
    "address_state": "SP",
    "address_postal_code": "01000-000",
    "address_country": "BRA"
  }
}
```

| Campo | Descrição |
|---|---|
| `id`, `name`, `merchant_ref`, `status`, `created_at`, `updated_at` | Os mesmos de [Listar merchants](https://doc.rapidchargeback.com/canais/merchants/listar-merchants/#sucesso) |
| `store_name` | Nome da loja como o portador conhece |
| `merchant_url` | Site da loja |
| `contact_phone` | Telefone de atendimento |
| `email` | E-mail de atendimento |
| `mcc` | Código do ramo da loja (ver [MCC](https://doc.rapidchargeback.com/referencia/glossario/#mcc-mcc)) |
| `description` | Descrição do que a loja vende |
| `logo_url` | Endereço do logo |
| `terms`, `terms_url` | Termos de uso (texto e endereço) |
| `refund_policy`, `refund_policy_url` | Política de reembolso (texto e endereço) |
| `customer_service_instructions` | Como o portador fala com a loja |
| `address_street`, `address_number`, `address_city`, `address_state`, `address_postal_code` | Endereço |
| `address_country` | País, código de 3 letras em maiúsculas (ex.: `BRA`) |

Campo sem valor vem `null`. É o mesmo objeto que [Criar ou atualizar merchant](https://doc.rapidchargeback.com/canais/merchants/criar-ou-atualizar-merchant/) e [Editar merchant](https://doc.rapidchargeback.com/canais/merchants/editar-merchant/) devolvem.

### Merchant não encontrado

```
HTTP/1.1 404 Not Found
```

```json
{
  "error": {
    "code": "MERCHANT_NOT_FOUND",
    "message": "Merchant not found"
  }
}
```

O mesmo `404` vale para um `merchant_id` que não existe, que é de outra empresa ou que não é um UUID.

---

## Notas

- **Só os merchants da sua empresa.** A empresa vem da credencial.
- **Auth, rate limit, códigos de erro:** ver [Autenticação](https://doc.rapidchargeback.com/referencia/autenticacao/) e [Códigos de resposta](https://doc.rapidchargeback.com/referencia/codigos-de-resposta/).
