Webhooks
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
La respuesta trae el secreto de firma (secret) una sola vez.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
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/jsonurl*stringDirección https de su servidor que recibe los avisos.
1 <= length <= 2048events?array<string>|Eventos que quiere recibir, o ["*"] para todos (por omisión). La lista con cuándo llega cada uno: Tipos de evento.
description?|Para qué es, para usted (no se manda en los eventos).
api_version?|La versión de la API en que llegan sus eventos (por ejemplo 2026-10-24); null o sin mandar: la de la cuenta. Así actualiza un endpoint a la vez.
Correcto.
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' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "url": "https://mi-plataforma.mx/webhooks/fiscalisto", "events": [ "invoice.stamped", "invoice.failed", "invoice.canceled" ]}'{ "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"}