Enrollments: visión general
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.
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. 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
Sección titulada «Productos»Cada enrollment puede valer para uno o dos productos, cada uno con su propio estado:
| Producto en la API | Qué es |
|---|---|
alert | Alerta |
prevention | Prevención. 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
Sección titulada «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
Sección titulada «Cómo avanza la solicitud»- Solicitas el enrollment (Solicitar enrollment o Lote de enrollments). Todo producto solicitado nace
pending. - 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. - La sigues por la lista de enrollments con
updated_since. - Para detenerla, solicitas la desactivación. 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
Sección titulada «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.