Ir al contenido

↑↓ navegar ↵ abrir Ctrl↵ nueva pestaña esc cerrar

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_typeCamposCuándo usar
descriptordescriptor_value y descriptor_ruleEl nombre en el resumen del titular. descriptor_rule es exact (igual) o startswith (empieza con, al menos 5 caracteres)
bin_caidbin y caidEl 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.

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

Producto en la APIQué es
alertAlerta
preventionPrevenció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.

EstadoQué significa
pendingSolicitud hecha, esperando la aprobación del equipo de Rapid
activeAprobado: las alertas de ese identificador llegan
rejectedRechazado por el equipo. El motivo viene en rejection_reason
deactivation_requestedDesactivación solicitada. Sigue recibiendo hasta que el equipo confirme
inactiveDesactivado

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

  1. Solicitas el enrollment (Solicitar enrollment o 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 con updated_since.
  4. 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.

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.