# Solicitar desactivación

> Solicita la desactivación de los productos activos de un enrollment. El equipo de Rapid la confirma, y el enrollment sigue recibiendo alertas hasta la confirmación.

Página: https://doc.rapidchargeback.com/es/canais/enrollments/pedir-desativacao/

Solicita la desactivación de un enrollment de tu empresa. Todo producto `active` del enrollment pasa a `deactivation_requested`, y el equipo de Rapid confirma la desactivación.

**Hasta la confirmación, el enrollment sigue recibiendo alertas**, que siguen valiendo como siempre. Una vez confirmada, el producto queda `inactive`.

## Endpoint

```
POST https://api.rapidchargeback.com/api/v1/enrollments/:enrollment_id/request-deactivation
```

## Autenticación

```
Authorization: Basic base64(client_id:client_secret)
Content-Type: application/json
```

---

## Parámetros de URL

| Param | Tipo | Descripción |
|---|---|---|
| `enrollment_id` | string (UUID) | El `id` del enrollment |

## Cuerpo de la solicitud

Opcional.

| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `reason` | string (1 a 500) | No | El motivo, que el equipo de Rapid ve junto con la solicitud |

Un campo fuera de la tabla se rechaza con `422 VALIDATION_ERROR` (`Unknown field: <nombre>`).

### Repetir

| Situación | Respuesta |
|---|---|
| Algún producto `active` | `200`, `meta.result: "deactivation_requested"` |
| Ningún producto `active`, alguno ya en `deactivation_requested` | `200`, `meta.result: "unchanged"`. Nada cambia |
| Ningún producto `active` ni en `deactivation_requested` | `422 ENROLLMENT_NOTHING_TO_DEACTIVATE` |

Una solicitud todavía `pending` no se desactiva por aquí: solo un producto ya aprobado.

---

## Ejemplo de solicitud

```bash
curl -X POST https://api.rapidchargeback.com/api/v1/enrollments/00000000-0000-0000-0000-0000000000aa/request-deactivation \
  -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=" \
  -H "Content-Type: application/json" \
  -d '{ "reason": "El vendedor cerró la cuenta" }'
```

---

## Respuesta

### Éxito

```
HTTP/1.1 200 OK
```

```json
{
  "data": {
    "id": "00000000-0000-0000-0000-0000000000aa",
    "merchant_id": "00000000-0000-0000-0000-000000000001",
    "merchant_ref": "PB-1001",
    "enrollment_type": "descriptor",
    "descriptor_value": "loja exemplo",
    "descriptor_rule": "exact",
    "bin": null,
    "caid": null,
    "arn": null,
    "products": {
      "alert": { "status": "deactivation_requested", "rejection_reason": null, "approved_at": "2026-11-07T15:00:00.000Z" },
      "prevention": null
    },
    "created_at": "2026-11-06T12:00:00.000Z",
    "updated_at": "2026-12-01T10:00:00.000Z"
  },
  "meta": { "result": "deactivation_requested" }
}
```

### Nada para desactivar

```
HTTP/1.1 422 Unprocessable Entity
```

```json
{
  "error": {
    "code": "ENROLLMENT_NOTHING_TO_DEACTIVATE",
    "message": "No active products to deactivate on this enrollment"
  }
}
```

### Errores

| HTTP | Código | Cuándo |
|---|---|---|
| 404 | `ENROLLMENT_NOT_FOUND` | El enrollment no existe, es de otra empresa, o el id no es un UUID |
| 422 | `ENROLLMENT_NOTHING_TO_DEACTIVATE` | Ningún producto activo ni con desactivación solicitada |
| 422 | `VALIDATION_ERROR` | Campo desconocido, o `reason` vacío o de más de 500 caracteres (`params.field`) |
| 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

- **Un enrollment por llamada.** Para la salida de un vendedor, lista sus enrollments con [Listar enrollments](https://doc.rapidchargeback.com/es/canais/enrollments/listar-enrollments/) filtrando por `merchant_ref` y solicita la desactivación de cada uno.
- **Sigue la confirmación** por la [lista de enrollments](https://doc.rapidchargeback.com/es/canais/enrollments/listar-enrollments/#seguir-la-aprobación) con `updated_since`.
- **Actividad:** cada solicitud aparece en la Actividad del panel como hecha por la integración.
