Ir al contenido

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

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.

POST https://api.rapidchargeback.com/api/v1/enrollments/:enrollment_id/request-deactivation
Authorization: Basic base64(client_id:client_secret)
Content-Type: application/json

ParamTipoDescripción
enrollment_idstring (UUID)El id del enrollment

Opcional.

CampoTipoObligatorioDescripción
reasonstring (1 a 500)NoEl 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>).

SituaciónRespuesta
Algún producto active200, meta.result: "deactivation_requested"
Ningún producto active, alguno ya en deactivation_requested200, meta.result: "unchanged". Nada cambia
Ningún producto active ni en deactivation_requested422 ENROLLMENT_NOTHING_TO_DEACTIVATE

Una solicitud todavía pending no se desactiva por aquí: solo un producto ya aprobado.


Ventana de terminal
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" }'

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" }
}
HTTP/1.1 422 Unprocessable Entity
{
"error": {
"code": "ENROLLMENT_NOTHING_TO_DEACTIVATE",
"message": "No active products to deactivate on this enrollment"
}
}
HTTPCódigoCuándo
404ENROLLMENT_NOT_FOUNDEl enrollment no existe, es de otra empresa, o el id no es un UUID
422ENROLLMENT_NOTHING_TO_DEACTIVATENingún producto activo ni con desactivación solicitada
422VALIDATION_ERRORCampo desconocido, o reason vacío o de más de 500 caracteres (params.field)
403KYB_NOT_APPROVED, COMPANY_NOT_ACTIVE, COMPANY_BLOCKEDEmpresa sin registro aprobado, inactiva o bloqueada
429RATE_LIMIT_EXCEEDEDMás de 60 escrituras por minuto
503SERVICE_UNAVAILABLENo 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_ref y 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.