Cambiar Estado de Webhook

Activa o desactiva el webhook configurado

post/webhook/status

Autorización

apikeystringheaderrequerido

Cuerpo de la solicitud

application/json

statusstringrequerido

Estado del webhook: '0' = deshabilitado, '1' = habilitado

Respuesta

200Operación exitosa

successboolean

messagestring

Mensaje de estado

statusinteger

codestring

Código de respuesta

400Error de validación del estado: status_webhook_02 (estado no definido), status_webhook_03 (estado inválido, solo 0 o 1).

successboolean

Siempre false para respuestas de error

messagestring

Descripción del error en español

statusinteger

Campo legado dentro del cuerpo. Conserva su valor histórico (normalmente 200) y NO coincide con el status HTTP real: la respuesta puede llegar con HTTP 400/402/404/409/502 mientras este campo sigue en su valor legado. Usa el status HTTP de transporte y el code, no este campo.

codestring

Código de error estructurado ({dominio}_{número}). Identifica de forma única la causa del error para manejo programático.

401No autorizado: API Key no provista, inválida o expirada

successboolean

Siempre false

messagestring

Descripción del error de autenticación en español

statusinteger

Campo legado en el cuerpo. Es el status HTTP de transporte; para autenticación coincide con el status real (401). Usa el status HTTP y el code, no este campo.

codestring

Código de error de autenticación (auth_01, auth_03, auth_05)

403Prohibido: La dirección IP no está autorizada para acceder (IP whitelist)

successboolean

Siempre false

messagestring

Descripción del error

statusinteger

Campo legado en el cuerpo. Puede NO coincidir con el status HTTP real: para auth_06 y auth_07 este campo vale 401 (valor histórico congelado) mientras el status HTTP de transporte es 403. Usa el status HTTP y el code, no este campo.

codestring

Código de error: auth_04 (IP no autorizada), auth_06 (cuenta deshabilitada), auth_07 (admin inválido)

429Demasiadas peticiones: Límite de rate limit excedido (100 mensajes/segundo producción, 1000 envíos de prueba por día en sandbox)

successboolean

Siempre false

messagestring

Descripción del error

statusinteger

Código HTTP

codestring

Código de error de rate limit

500Error interno al actualizar el estado del webhook (status_webhook_04/status_webhook_05) o error inesperado (err_03).

successboolean

Siempre false

messagestring

Descripción del error

statusinteger

Campo legado dentro del cuerpo. Conserva su valor histórico (p.ej. 200 o 401 según el endpoint) y NO coincide con el status HTTP real (500). Usa el status HTTP de transporte y el code, no este campo.

codestring

Código de error interno (p.ej. server_01, o auth_99 en un error interno de autenticación)

request_idstring· uuid

Identificador único de la petición. Inclúyelo al contactar a soporte.

Además de los errores globales de autenticación (auth_*, ver Errores y límites), este endpoint puede responder:

Códigos de error

Código	Cuándo ocurre	Qué hacer
`status_webhook_02` / `status_webhook_03`	`status` ausente o distinto de `0`/`1`.	Envía `"1"` (habilitar) o `"0"` (deshabilitar).
`status_webhook_04`	No se pudo actualizar.	Verifica que tengas un webhook registrado con `/webhook/get`.

El éxito responde status_webhook_01.