FISCALISTO / API / REFERENCIA
Borrar un webhook DELETE
Deja de mandar eventos a esa dirección. Los eventos siguen en GET /v1/events.
Mandar un evento de prueba POST
Manda ahora, una sola vez y sin reintentos, un evento del tipo que elija con un objeto de ejemplo (sus id no existen), firmado como los reales, aunque el webhook no escuche ese tipo. La respuesta trae lo que contestó su servidor. El evento no sale en GET /v1/events, pero sí en las entregas del webhook.
Un secreto nuevo, que la respuesta trae una sola vez. El anterior sigue firmando (una segunda firma en webhook-signature) el tiempo que elija, 24 horas por omisión, para que cambie su servidor sin rechazar eventos. Si se filtró, mande previous_secret_expires_in: 0.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
Idempotency-Key?stringOpcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra).
1 <= length <= 255application/jsonprevious_secret_expires_in?integerSegundos que el secreto anterior sigue firmando, de 0 (deja de firmar ya: úselo si se filtró) a 86400. Por omisión 86400 (24 horas).
0 <= value <= 86400Correcto.
application/jsonUna dirección de su servidor que recibe eventos.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
object*stringQué tipo de objeto es («invoice», «customer»…).
sandbox*|El entorno de prueba (sbx_…) al que pertenece, o null si es de la cuenta. Vea /v1/sandboxes.
url*stringDirección https de su servidor que recibe los avisos.
description*|Para qué es, para usted.
events*array<string>Eventos que quiere recibir, o ["*"] para todos (por omisión). La lista con cuándo llega cada uno: Tipos de evento.
status*stringenabled: entregando. failing: sus entregas fallan (se apaga tras 5 días así). disabled: apagado.
"enabled""failing""disabled"disabled_reason?|Por qué se apagó (sus entregas fallaron 5 días seguidos, o usted lo apagó).
failing_since?|Desde cuándo fallan las entregas, o null.
previous_secret_expires_at*|Hasta cuándo el secreto anterior también firma (después de cambiarlo), o null.
api_version*|La versión de la API de sus eventos; null: la de la cuenta.
created_at*|Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
secret?stringSecreto de firma (whsec_…). Solo viene al crearlo o al cambiarlo: guárdelo para verificar las firmas.
curl -X POST 'https://api.fiscalisto.com/v1/webhook_endpoints/string/roll_secret' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "previous_secret_expires_in": 3600}'{ "id": "whe_0q1Vmmw52sbDpmtsKD1E", "object": "webhook_endpoint", "livemode": false, "sandbox": null, "url": "https://mi-plataforma.mx/webhooks/fiscalisto", "description": null, "events": [ "invoice.stamped" ], "status": "enabled", "disabled_reason": null, "failing_since": null, "previous_secret_expires_at": null, "api_version": null, "created_at": "2026-10-24T10:15:42-06:00", "secret": "whsec_MfKQ9r7Cq1ZzR0nN3xY2bW8eT5uV6sA4"}