# Enrollments: visão geral

> O que é um enrollment, os tipos descriptor e BIN + CAID, o status de cada produto e como o pedido passa pela aprovação da equipe da Rapid.

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

Um **enrollment** é o cadastro de um identificador de cobrança de um merchant seu: o nome que aparece na fatura do cartão (**descriptor**) ou o par **BIN + CAID** da loja. É pelo enrollment que a Rapid reconhece que um alerta é seu e de qual merchant ele é: sem enrollment aprovado, o alerta não chega.

Pela API você pede enrollments, acompanha a aprovação e pede a desativação. Quem aprova é a equipe da Rapid.

## Tipos

| `enrollment_type` | Campos | Quando usar |
|---|---|---|
| `descriptor` | `descriptor_value` e `descriptor_rule` | O nome na fatura do portador. `descriptor_rule` é `exact` (igual) ou `startswith` (começa com, pelo menos 5 caracteres) |
| `bin_caid` | `bin` e `caid` | O BIN do cartão (6 a 10 dígitos) e o CAID (identificador da loja no adquirente) |

Qual tipo cada bandeira usa está em [Alerta: visão geral](https://doc.rapidchargeback.com/produtos/alerta/visao-geral/). O `descriptor_value` é gravado em minúsculas; diferença de maiúsculas, espaços repetidos e espaços em volta do `*` não criam outro enrollment.

## Produtos

Cada enrollment pode valer para um ou dois produtos, cada um com o próprio status:

| Produto na API | O que é |
|---|---|
| `alert` | [Alerta](https://doc.rapidchargeback.com/produtos/alerta/visao-geral/) |
| `prevention` | [Prevenção](https://doc.rapidchargeback.com/produtos/prevencao/visao-geral/). Exige o cadastro do merchant: sempre `store_name`, `merchant_url` e `contact_phone`; conforme o caso, também endereço completo e os dados da loja (descrição, logo, MCC, termos, política de reembolso e atendimento). O erro `MERCHANT_INCOMPLETE_FOR_PREVENTION` diz o que falta em `params.fields` |

A sua empresa precisa ter o produto contratado para pedir enrollment nele.

## Status de cada produto

| Status | O que significa |
|---|---|
| `pending` | Pedido feito, esperando a aprovação da equipe da Rapid |
| `active` | Aprovado: os alertas desse identificador chegam |
| `rejected` | Recusado pela equipe. O motivo vem em `rejection_reason` |
| `deactivation_requested` | Desativação pedida. **Continua recebendo** até a equipe confirmar |
| `inactive` | Desativado |

O produto que nunca foi pedido vem `null` em `products`.

## Como o pedido anda

1. Você pede o enrollment ([Pedir enrollment](https://doc.rapidchargeback.com/canais/enrollments/pedir-enrollment/) ou [Lote de enrollments](https://doc.rapidchargeback.com/canais/enrollments/lote-de-enrollments/)). Todo produto pedido nasce `pending`.
2. O pedido passa pela aprovação da equipe da Rapid, que aprova (`active`) ou recusa (`rejected`, com motivo). O responsável pela sua conta recebe o aviso no painel e por e-mail.
3. Você acompanha pela [lista de enrollments](https://doc.rapidchargeback.com/canais/enrollments/listar-enrollments/) com `updated_since`.
4. Para parar, você [pede a desativação](https://doc.rapidchargeback.com/canais/enrollments/pedir-desativacao/). A equipe confirma, e até lá o enrollment continua recebendo alertas.

Enrollment não se edita: para trocar o identificador, peça um novo e a desativação do antigo.

## Um identificador, um dono

O mesmo descriptor ou BIN + CAID só pode estar em uso (`pending`, `active` ou `deactivation_requested`) em um enrollment de toda a plataforma. Pedir um identificador que já está em uso responde `409 ENROLLMENT_DUPLICATE`; se o enrollment em uso é da sua empresa, a resposta traz o id dele.

## Páginas desta seção

- [Pedir enrollment](https://doc.rapidchargeback.com/canais/enrollments/pedir-enrollment/)
- [Lote de enrollments](https://doc.rapidchargeback.com/canais/enrollments/lote-de-enrollments/)
- [Listar enrollments](https://doc.rapidchargeback.com/canais/enrollments/listar-enrollments/)
- [Consultar enrollment](https://doc.rapidchargeback.com/canais/enrollments/consultar-enrollment/)
- [Pedir desativação](https://doc.rapidchargeback.com/canais/enrollments/pedir-desativacao/)
