Listar enrollments
Lista los enrollments de tu empresa (ver Enrollments: visión general). Úsala para seguir la aprobación de las solicitudes, encontrar los enrollments de un vendedor o revisar si un identificador ya está registrado.
Endpoint
Sección titulada «Endpoint»https://api.rapidchargeback.com/api/v1/enrollmentsAutenticación
Sección titulada «Autenticación»Authorization: Basic base64(client_id:client_secret)Query params
Sección titulada «Query params»Todos opcionales. Un parámetro fuera de esta tabla se rechaza con 422 VALIDATION_ERROR (Unknown field: <nombre>).
| Param | Tipo | Default | Descripción |
|---|---|---|---|
page | int (≥ 1) | 1 | Página |
per_page | int (1–100) | 20 | Ítems por página |
merchant_id | string (UUID) | - | Solo los enrollments de ese merchant |
merchant_ref | string (hasta 100) | - | Solo los enrollments del merchant con esa referencia de tu sistema. Sin merchant con la referencia, la lista viene vacía. La comparación no distingue mayúsculas ni acentos |
enrollment_type | enum | - | descriptor o bin_caid |
product | enum | - | alert o prevention. Solo: los enrollments en los que se solicitó el producto |
status | enum | - | pending, active, deactivation_requested, inactive o rejected. Sin product: algún producto en ese estado. Con product: solo ese producto |
descriptor_value | string (hasta 255) | - | El valor exacto, sin distinguir mayúsculas |
bin | string (6 a 10 dígitos) | - | BIN exacto |
caid | string (hasta 50) | - | CAID exacto |
updated_since | fecha y hora ISO 8601 con zona horaria | - | Solo los enrollments modificados a partir de ese instante (ej.: 2026-11-06T12:00:00Z) |
Con merchant_id y merchant_ref juntos, los dos deben apuntar al mismo merchant; si no, la lista viene vacía.
Sin updated_since, el orden es el de solicitud (el más antiguo primero, después id). Con updated_since, solo lo que cambió a partir de ese instante, del más antiguo al más nuevo (updated_at, después id).
Seguir la aprobación
Sección titulada «Seguir la aprobación»Para saber cuándo una solicitud fue aprobada o rechazada, consulta esta lista con updated_since cada pocos minutos:
- Guarda el mayor
updated_atque recibiste. - En la consulta siguiente, envía ese valor menos 2 minutos como
updated_since. - Ignora el par (
id,updated_at) que ya procesaste. - Lee las páginas hasta
total_pages.
El margen de 2 minutos cubre el cambio guardado fuera de orden o durante tu lectura.
Ejemplos
Sección titulada «Ejemplos»Los enrollments de un vendedor
Sección titulada «Los enrollments de un vendedor»curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \ --data-urlencode "merchant_ref=PB-1001" \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Lo que cambió desde la última lectura
Sección titulada «Lo que cambió desde la última lectura»curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \ --data-urlencode "updated_since=2026-11-07T14:58:00Z" \ --data-urlencode "per_page=100" \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Alertas esperando aprobación
Sección titulada «Alertas esperando aprobación»curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \ --data-urlencode "product=alert" \ --data-urlencode "status=pending" \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Respuesta
Sección titulada «Respuesta»{ "data": [ { "id": "00000000-0000-0000-0000-0000000000aa", "merchant_id": "00000000-0000-0000-0000-000000000001", "merchant_ref": "PB-1001", "enrollment_type": "descriptor", "descriptor_value": "loja exemplo", "descriptor_rule": "exact", "bin": null, "caid": null, "arn": null, "products": { "alert": { "status": "active", "rejection_reason": null, "approved_at": "2026-11-07T15:00:00.000Z" }, "prevention": null }, "created_at": "2026-11-06T12:00:00.000Z", "updated_at": "2026-11-07T15:00:00.000Z" } ], "meta": { "page": 1, "per_page": 20, "total": 1, "total_pages": 1 }}Los campos están en Solicitar enrollment.
Parámetro desconocido
Sección titulada «Parámetro desconocido»{ "error": { "code": "VALIDATION_ERROR", "message": "Unknown field: merchant", "params": { "field": "merchant" } }}- Solo los enrollments de tu empresa. La empresa viene de la credencial.
- Empresa bloqueada recibe
403 COMPANY_BLOCKED. - Auth, rate limit, códigos de error: ver Autenticación y Códigos de respuesta.