Ir al contenido

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

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.

GET https://api.rapidchargeback.com/api/v1/enrollments
Authorization: Basic base64(client_id:client_secret)

Todos opcionales. Un parámetro fuera de esta tabla se rechaza con 422 VALIDATION_ERROR (Unknown field: <nombre>).

ParamTipoDefaultDescripción
pageint (≥ 1)1Página
per_pageint (1–100)20Ítems por página
merchant_idstring (UUID)-Solo los enrollments de ese merchant
merchant_refstring (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_typeenum-descriptor o bin_caid
productenum-alert o prevention. Solo: los enrollments en los que se solicitó el producto
statusenum-pending, active, deactivation_requested, inactive o rejected. Sin product: algún producto en ese estado. Con product: solo ese producto
descriptor_valuestring (hasta 255)-El valor exacto, sin distinguir mayúsculas
binstring (6 a 10 dígitos)-BIN exacto
caidstring (hasta 50)-CAID exacto
updated_sincefecha 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).

Para saber cuándo una solicitud fue aprobada o rechazada, consulta esta lista con updated_since cada pocos minutos:

  1. Guarda el mayor updated_at que recibiste.
  2. En la consulta siguiente, envía ese valor menos 2 minutos como updated_since.
  3. Ignora el par (id, updated_at) que ya procesaste.
  4. Lee las páginas hasta total_pages.

El margen de 2 minutos cubre el cambio guardado fuera de orden o durante tu lectura.


Ventana de terminal
curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \
--data-urlencode "merchant_ref=PB-1001" \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="
Ventana de terminal
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="
Ventana de terminal
curl -G "https://api.rapidchargeback.com/api/v1/enrollments" \
--data-urlencode "product=alert" \
--data-urlencode "status=pending" \
-H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="

{
"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.

{
"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.