# Remover merchant

> Apaga um merchant da sua empresa que não tem nenhum dado ligado. Merchant com histórico não se apaga: use status inactive.

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

Apaga um merchant da sua empresa. Só funciona com merchant **sem nenhum dado ligado**: nenhuma transação, alerta, evento, disputa, evidência ou enrollment. É para desfazer um cadastro feito por engano.

Merchant com histórico não se apaga. Para marcar que ele saiu, grave `status: "inactive"` com [Editar merchant](https://doc.rapidchargeback.com/canais/merchants/editar-merchant/); para deixar de receber alertas dele, [peça a desativação](https://doc.rapidchargeback.com/canais/enrollments/pedir-desativacao/) dos enrollments.

## Endpoint

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

---

## Exemplo de requisição

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

---

## Resposta

### Apagado

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

Sem corpo.

### Merchant com histórico

```
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"
  }
}
```

Nada foi apagado. Como a mensagem orienta, grave `status: "inactive"` e peça a desativação dos enrollments (ver acima).

### Erros

| HTTP | Código | Quando |
|---|---|---|
| 404 | `MERCHANT_NOT_FOUND` | O merchant não existe, é de outra empresa, ou o id não é um UUID |
| 409 | `MERCHANT_HAS_HISTORY` | O merchant tem dado ligado |
| 403 | `KYB_NOT_APPROVED`, `COMPANY_NOT_ACTIVE`, `COMPANY_BLOCKED` | Empresa sem cadastro aprovado, inativa ou bloqueada |
| 429 | `RATE_LIMIT_EXCEEDED` | Mais de 60 escritas por minuto |
| 503 | `SERVICE_UNAVAILABLE` | Indisponibilidade temporária: repita depois do `Retry-After` |

---

## Notas

- **Repetir depois de um `503`:** se o merchant já tinha sido apagado, a nova chamada responde `404 MERCHANT_NOT_FOUND`.
- **Atividade:** a remoção aparece na Atividade do painel como feita pela integração.
