# Eliminar merchant

> Elimina un merchant de tu empresa que no tiene ningún dato vinculado. Un merchant con historial no se elimina: usa status inactive.

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

Elimina un merchant de tu empresa. Solo funciona con un merchant **sin ningún dato vinculado**: ninguna transacción, alerta, evento, disputa, evidencia o enrollment. Sirve para deshacer un registro hecho por error.

Un merchant con historial no se elimina. Para marcar que salió, guarda `status: "inactive"` con [Editar merchant](https://doc.rapidchargeback.com/es/canais/merchants/editar-merchant/); para dejar de recibir sus alertas, [solicita la desactivación](https://doc.rapidchargeback.com/es/canais/enrollments/pedir-desativacao/) de los enrollments.

## Endpoint

```
DELETE 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 |

---

## Ejemplo de solicitud

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

---

## Respuesta

### Eliminado

```
HTTP/1.1 204 No Content
```

Sin cuerpo.

### Merchant con historial

```
HTTP/1.1 409 Conflict
```

```json
{
  "error": {
    "code": "MERCHANT_HAS_HISTORY",
    "message": "Merchant has data (transactions, alerts, events, disputes or enrollments) and cannot be deleted. Set its status to inactive and request deactivation of its enrollments instead"
  }
}
```

No se eliminó nada. Como indica el mensaje, guarda `status: "inactive"` y solicita la desactivación de los enrollments (ver arriba).

### Errores

| HTTP | Código | Cuándo |
|---|---|---|
| 404 | `MERCHANT_NOT_FOUND` | El merchant no existe, es de otra empresa, o el id no es un UUID |
| 409 | `MERCHANT_HAS_HISTORY` | El merchant tiene datos vinculados |
| 403 | `KYB_NOT_APPROVED`, `COMPANY_NOT_ACTIVE`, `COMPANY_BLOCKED` | Empresa sin registro aprobado, inactiva o bloqueada |
| 429 | `RATE_LIMIT_EXCEEDED` | Más de 60 escrituras por minuto |
| 503 | `SERVICE_UNAVAILABLE` | No disponible temporalmente: repite después del `Retry-After` |

---

## Notas

- **Repetir después de un `503`:** si el merchant ya se había eliminado, la nueva llamada responde `404 MERCHANT_NOT_FOUND`.
- **Actividad:** la eliminación aparece en la Actividad del panel como hecha por la integración.
