# Consultar merchant

> Devuelve el registro completo de un merchant de tu empresa por el merchant_id: contacto, dirección, términos y la referencia de tu sistema.

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

Devuelve el registro completo de un merchant de tu empresa. Para encontrar el `merchant_id`, usa [Listar merchants](https://doc.rapidchargeback.com/es/canais/merchants/listar-merchants/) (también por el `merchant_ref`, el ID del vendedor en tu sistema).

## Endpoint

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

## Autenticación

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

---

## Parámetros de URL

| Param | Tipo | Descripción |
|---|---|---|
| `merchant_id` | string (UUID) | El `id` del merchant |

Esta ruta no acepta query params: cualquier parámetro en la URL se rechaza con `422 VALIDATION_ERROR` (`Unknown field: <nombre>`).

---

## Ejemplo de solicitud

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

---

## Respuesta

### Éxito

```
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 | Descripción |
|---|---|
| `id`, `name`, `merchant_ref`, `status`, `created_at`, `updated_at` | Los mismos de [Listar merchants](https://doc.rapidchargeback.com/es/canais/merchants/listar-merchants/#éxito) |
| `store_name` | Nombre de la tienda como la conoce el titular |
| `merchant_url` | Sitio de la tienda |
| `contact_phone` | Teléfono de atención |
| `email` | Correo de atención |
| `mcc` | Código del rubro de la tienda (ver [MCC](https://doc.rapidchargeback.com/es/referencia/glossario/#mcc-mcc)) |
| `description` | Descripción de lo que vende la tienda |
| `logo_url` | Dirección del logo |
| `terms`, `terms_url` | Términos de uso (texto y dirección) |
| `refund_policy`, `refund_policy_url` | Política de reembolso (texto y dirección) |
| `customer_service_instructions` | Cómo el titular contacta a la tienda |
| `address_street`, `address_number`, `address_city`, `address_state`, `address_postal_code` | Dirección |
| `address_country` | País, código de 3 letras en mayúsculas (ej.: `BRA`) |

El campo sin valor viene `null`. Es el mismo objeto que devuelven [Crear o actualizar merchant](https://doc.rapidchargeback.com/es/canais/merchants/criar-ou-atualizar-merchant/) y [Editar merchant](https://doc.rapidchargeback.com/es/canais/merchants/editar-merchant/).

### Merchant no encontrado

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

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

El mismo `404` vale para un `merchant_id` que no existe, que es de otra empresa o que no es un UUID.

---

## Notas

- **Solo los merchants de tu empresa.** La empresa viene de la credencial.
- **Auth, rate limit, códigos de error:** ver [Autenticación](https://doc.rapidchargeback.com/es/referencia/autenticacao/) y [Códigos de respuesta](https://doc.rapidchargeback.com/es/referencia/codigos-de-resposta/).
