# Enrollments: visión general

> Qué es un enrollment, los tipos descriptor y BIN + CAID, el estado de cada producto y cómo la solicitud pasa por la aprobación del equipo de Rapid.

Página: https://doc.rapidchargeback.com/es/canais/enrollments/visao-geral/

Un **enrollment** es el registro de un identificador de cobro de un merchant tuyo: el nombre que aparece en el resumen de la tarjeta (**descriptor**) o el par **BIN + CAID** de la tienda. Por el enrollment Rapid reconoce que una alerta es tuya y de qué merchant es: sin enrollment aprobado, la alerta no llega.

Por la API solicitas enrollments, sigues la aprobación y solicitas la desactivación. Quien aprueba es el equipo de Rapid.

## Tipos

| `enrollment_type` | Campos | Cuándo usar |
|---|---|---|
| `descriptor` | `descriptor_value` y `descriptor_rule` | El nombre en el resumen del titular. `descriptor_rule` es `exact` (igual) o `startswith` (empieza con, al menos 5 caracteres) |
| `bin_caid` | `bin` y `caid` | El BIN de la tarjeta (6 a 10 dígitos) y el CAID (identificador de la tienda en el adquirente) |

Qué tipo usa cada marca está en [Alerta: visión general](https://doc.rapidchargeback.com/es/produtos/alerta/visao-geral/). El `descriptor_value` se guarda en minúsculas; la diferencia de mayúsculas, los espacios repetidos y los espacios alrededor del `*` no crean otro enrollment.

## Productos

Cada enrollment puede valer para uno o dos productos, cada uno con su propio estado:

| Producto en la API | Qué es |
|---|---|
| `alert` | [Alerta](https://doc.rapidchargeback.com/es/produtos/alerta/visao-geral/) |
| `prevention` | [Prevención](https://doc.rapidchargeback.com/es/produtos/prevencao/visao-geral/). Exige el registro del merchant: siempre `store_name`, `merchant_url` y `contact_phone`; según el caso, también dirección completa y los datos de la tienda (descripción, logo, MCC, términos, política de reembolso y atención). El error `MERCHANT_INCOMPLETE_FOR_PREVENTION` indica lo que falta en `params.fields` |

Tu empresa necesita tener el producto contratado para solicitar un enrollment en él.

## Estado de cada producto

| Estado | Qué significa |
|---|---|
| `pending` | Solicitud hecha, esperando la aprobación del equipo de Rapid |
| `active` | Aprobado: las alertas de ese identificador llegan |
| `rejected` | Rechazado por el equipo. El motivo viene en `rejection_reason` |
| `deactivation_requested` | Desactivación solicitada. **Sigue recibiendo** hasta que el equipo confirme |
| `inactive` | Desactivado |

El producto que nunca se solicitó viene `null` en `products`.

## Cómo avanza la solicitud

1. Solicitas el enrollment ([Solicitar enrollment](https://doc.rapidchargeback.com/es/canais/enrollments/pedir-enrollment/) o [Lote de enrollments](https://doc.rapidchargeback.com/es/canais/enrollments/lote-de-enrollments/)). Todo producto solicitado nace `pending`.
2. La solicitud pasa por la aprobación del equipo de Rapid, que aprueba (`active`) o rechaza (`rejected`, con motivo). El responsable de tu cuenta recibe el aviso en el panel y por correo.
3. La sigues por la [lista de enrollments](https://doc.rapidchargeback.com/es/canais/enrollments/listar-enrollments/) con `updated_since`.
4. Para detenerla, [solicitas la desactivación](https://doc.rapidchargeback.com/es/canais/enrollments/pedir-desativacao/). El equipo la confirma, y hasta entonces el enrollment sigue recibiendo alertas.

Un enrollment no se edita: para cambiar el identificador, solicita uno nuevo y la desactivación del anterior.

## Un identificador, un dueño

El mismo descriptor o BIN + CAID solo puede estar en uso (`pending`, `active` o `deactivation_requested`) en un enrollment de toda la plataforma. Solicitar un identificador que ya está en uso responde `409 ENROLLMENT_DUPLICATE`; si el enrollment en uso es de tu empresa, la respuesta trae su id.

## Páginas de esta sección

- [Solicitar enrollment](https://doc.rapidchargeback.com/es/canais/enrollments/pedir-enrollment/)
- [Lote de enrollments](https://doc.rapidchargeback.com/es/canais/enrollments/lote-de-enrollments/)
- [Listar enrollments](https://doc.rapidchargeback.com/es/canais/enrollments/listar-enrollments/)
- [Consultar enrollment](https://doc.rapidchargeback.com/es/canais/enrollments/consultar-enrollment/)
- [Solicitar desactivación](https://doc.rapidchargeback.com/es/canais/enrollments/pedir-desativacao/)
