# Enrollments: overview

> What an enrollment is, the descriptor and BIN + CAID types, the status of each product and how the request goes through approval by the Rapid team.

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

An **enrollment** is the registration of a billing identifier of one of your merchants: the name shown on the card statement (**descriptor**) or the store's **BIN + CAID** pair. Through the enrollment Rapid recognizes that an alert is yours and which merchant it belongs to: without an approved enrollment, the alert does not arrive.

Through the API you request enrollments, follow the approval and request deactivation. The Rapid team is the one who approves.

## Types

| `enrollment_type` | Fields | When to use |
|---|---|---|
| `descriptor` | `descriptor_value` and `descriptor_rule` | The name on the cardholder's statement. `descriptor_rule` is `exact` (equal) or `startswith` (starts with, at least 5 characters) |
| `bin_caid` | `bin` and `caid` | The card BIN (6 to 10 digits) and the CAID (the store's identifier at the acquirer) |

Which type each card network uses is in [Alert: overview](https://doc.rapidchargeback.com/en/produtos/alerta/visao-geral/). The `descriptor_value` is saved in lowercase; case differences, repeated spaces and spaces around `*` do not create another enrollment.

## Products

Each enrollment can apply to one or two products, each with its own status:

| Product in the API | What it is |
|---|---|
| `alert` | [Alert](https://doc.rapidchargeback.com/en/produtos/alerta/visao-geral/) |
| `prevention` | [Prevention](https://doc.rapidchargeback.com/en/produtos/prevencao/visao-geral/). Requires the merchant's registration: always `store_name`, `merchant_url` and `contact_phone`; depending on the case, also a full address and the store details (description, logo, MCC, terms, refund policy and customer service). The `MERCHANT_INCOMPLETE_FOR_PREVENTION` error lists what is missing in `params.fields` |

Your company needs to have the product contracted to request an enrollment on it.

## Status of each product

| Status | What it means |
|---|---|
| `pending` | Requested, waiting for approval by the Rapid team |
| `active` | Approved: alerts for this identifier arrive |
| `rejected` | Rejected by the team. The reason comes in `rejection_reason` |
| `deactivation_requested` | Deactivation requested. **Keeps receiving** until the team confirms |
| `inactive` | Deactivated |

A product that was never requested comes as `null` in `products`.

## How the request moves

1. You request the enrollment ([Request enrollment](https://doc.rapidchargeback.com/en/canais/enrollments/pedir-enrollment/) or [Enrollment batch](https://doc.rapidchargeback.com/en/canais/enrollments/lote-de-enrollments/)). Every requested product starts as `pending`.
2. The request goes through approval by the Rapid team, which approves it (`active`) or rejects it (`rejected`, with a reason). The person in charge of your account gets the notice in the dashboard and by email.
3. You follow it through the [enrollments list](https://doc.rapidchargeback.com/en/canais/enrollments/listar-enrollments/) with `updated_since`.
4. To stop, you [request the deactivation](https://doc.rapidchargeback.com/en/canais/enrollments/pedir-desativacao/). The team confirms it, and until then the enrollment keeps receiving alerts.

An enrollment cannot be edited: to change the identifier, request a new one and the deactivation of the old one.

## One identifier, one owner

The same descriptor or BIN + CAID can only be in use (`pending`, `active` or `deactivation_requested`) in one enrollment across the whole platform. Requesting an identifier already in use responds `409 ENROLLMENT_DUPLICATE`; if the enrollment in use is your company's, the response brings its id.

## Pages in this section

- [Request enrollment](https://doc.rapidchargeback.com/en/canais/enrollments/pedir-enrollment/)
- [Enrollment batch](https://doc.rapidchargeback.com/en/canais/enrollments/lote-de-enrollments/)
- [List enrollments](https://doc.rapidchargeback.com/en/canais/enrollments/listar-enrollments/)
- [Get enrollment](https://doc.rapidchargeback.com/en/canais/enrollments/consultar-enrollment/)
- [Request deactivation](https://doc.rapidchargeback.com/en/canais/enrollments/pedir-desativacao/)
