Eliminar merchant
Elimina un merchant de tu empresa. Solo funciona con un merchant sin ningún dato vinculado: ninguna transacción, alerta, evento, disputa, evidencia o enrollment. Sirve para deshacer un registro hecho por error.
Un merchant con historial no se elimina. Para marcar que salió, guarda status: "inactive" con Editar merchant; para dejar de recibir sus alertas, solicita la desactivación de los enrollments.
Endpoint
Sección titulada «Endpoint»DELETE
https://api.rapidchargeback.com/api/v1/merchants/:merchant_idAutenticación
Sección titulada «Autenticación»Authorization: Basic base64(client_id:client_secret)Parámetros de URL
Sección titulada «Parámetros de URL»| Param | Tipo | Descripción |
|---|---|---|
merchant_id | string (UUID) | El id del merchant |
Ejemplo de solicitud
Sección titulada «Ejemplo de solicitud»curl -X DELETE https://api.rapidchargeback.com/api/v1/merchants/00000000-0000-0000-0000-000000000001 \ -H "Authorization: Basic Y2xpZW50X2lkOmNsaWVudF9zZWNyZXQ="Respuesta
Sección titulada «Respuesta»Eliminado
Sección titulada «Eliminado»HTTP/1.1 204 No ContentSin cuerpo.
Merchant con historial
Sección titulada «Merchant con historial»HTTP/1.1 409 Conflict{ "error": { "code": "MERCHANT_HAS_HISTORY", "message": "Merchant has data (transactions, alerts, events, disputes or enrollments) and cannot be deleted. Set its status to inactive and request deactivation of its enrollments instead" }}No se eliminó nada. Como indica el mensaje, guarda status: "inactive" y solicita la desactivación de los enrollments (ver arriba).
Errores
Sección titulada «Errores»| HTTP | Código | Cuándo |
|---|---|---|
| 404 | MERCHANT_NOT_FOUND | El merchant no existe, es de otra empresa, o el id no es un UUID |
| 409 | MERCHANT_HAS_HISTORY | El merchant tiene datos vinculados |
| 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 |
- Repetir después de un
503: si el merchant ya se había eliminado, la nueva llamada responde404 MERCHANT_NOT_FOUND. - Actividad: la eliminación aparece en la Actividad del panel como hecha por la integración.