Webhooks
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Un webhook: su dirección, los eventos que recibe y si sus entregas fallan. El secreto solo viene al crearlo.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
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 GET 'https://api.fiscalisto.com/v1/webhook_endpoints/string' \ -H 'Authorization: Bearer fk_test_…'{ "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"}