Solicitar desactivación
Solicita la desactivación de un enrollment de tu empresa. Todo producto active del enrollment pasa a deactivation_requested, y el equipo de Rapid confirma la desactivación.
Hasta la confirmación, el enrollment sigue recibiendo alertas, que siguen valiendo como siempre. Una vez confirmada, el producto queda inactive.
Endpoint
Sección titulada «Endpoint»POST
https://api.rapidchargeback.com/api/v1/enrollments/:enrollment_id/request-deactivationAutenticación
Sección titulada «Autenticación»Authorization: Basic base64(client_id:client_secret)Content-Type: application/jsonParámetros de URL
Sección titulada «Parámetros de URL»| Param | Tipo | Descripción |
|---|---|---|
enrollment_id | string (UUID) | El id del enrollment |
Cuerpo de la solicitud
Sección titulada «Cuerpo de la solicitud»Opcional.
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
reason | string (1 a 500) | No | El motivo, que el equipo de Rapid ve junto con la solicitud |
Un campo fuera de la tabla se rechaza con 422 VALIDATION_ERROR (Unknown field: <nombre>).
Repetir
Sección titulada «Repetir»| Situación | Respuesta |
|---|---|
Algún producto active | 200, meta.result: "deactivation_requested" |
Ningún producto active, alguno ya en deactivation_requested | 200, meta.result: "unchanged". Nada cambia |
Ningún producto active ni en deactivation_requested | 422 ENROLLMENT_NOTHING_TO_DEACTIVATE |
Una solicitud todavía pending no se desactiva por aquí: solo un producto ya aprobado.
Ejemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl -X POST https://api.rapidchargeback.com/api/v1/enrollments/00000000-0000-0000-0000-0000000000aa/request-deactivation \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ=" \ -H "Content-Type: application/json" \ -d '{ "reason": "El vendedor cerró la cuenta" }'Respuesta
Sección titulada «Respuesta»HTTP/1.1 200 OK{ "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": "deactivation_requested", "rejection_reason": null, "approved_at": "2026-11-07T15:00:00.000Z" }, "prevention": null }, "created_at": "2026-11-06T12:00:00.000Z", "updated_at": "2026-12-01T10:00:00.000Z" }, "meta": { "result": "deactivation_requested" }}Nada para desactivar
Sección titulada «Nada para desactivar»HTTP/1.1 422 Unprocessable Entity{ "error": { "code": "ENROLLMENT_NOTHING_TO_DEACTIVATE", "message": "No active products to deactivate on this enrollment" }}Errores
Sección titulada «Errores»| HTTP | Código | Cuándo |
|---|---|---|
| 404 | ENROLLMENT_NOT_FOUND | El enrollment no existe, es de otra empresa, o el id no es un UUID |
| 422 | ENROLLMENT_NOTHING_TO_DEACTIVATE | Ningún producto activo ni con desactivación solicitada |
| 422 | VALIDATION_ERROR | Campo desconocido, o reason vacío o de más de 500 caracteres (params.field) |
| 403 | KYB_NOT_APPROVED, COMPANY_NOT_ACTIVE, COMPANY_BLOCKED | Empresa sin registro aprobado, inactiva o bloqueada |
| 429 | RATE_LIMIT_EXCEEDED | Más de 60 escrituras por minuto |
| 503 | SERVICE_UNAVAILABLE | No disponible temporalmente: repite después del Retry-After |
- Un enrollment por llamada. Para la salida de un vendedor, lista sus enrollments con Listar enrollments filtrando por
merchant_refy solicita la desactivación de cada uno. - Sigue la confirmación por la lista de enrollments con
updated_since. - Actividad: cada solicitud aparece en la Actividad del panel como hecha por la integración.