FISCALISTO / API / REFERENCIA
Cambiar el secreto POST
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.
Tipos de evento
Siguiente
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.
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/jsontype?stringEl evento a mandar. Por omisión invoice.stamped.
"invoice.stamped""invoice.stamped""invoice.failed""invoice.canceled""invoice.cancellation_pending""invoice.cancellation_rejected""invoice.paid""invoice.partially_paid""retention.stamped""retention.failed""retention.canceled""invoice_batch.completed""customer_data_request.completed""sat_download.completed""sat_download.failed""sat_declaration.created""sat_declaration.updated""ticket.invoiced""ticket.included_in_global""recurring_invoice.failed""quote.viewed""quote.accepted""quote.changes_requested""quote.rejected""issuer.ready""balance.low""test_clock.ready"Correcto.
application/jsonUn evento de prueba que se mandó a su webhook, y lo que respondió su servidor.
object*stringQué tipo de objeto es («invoice», «customer»…).
event*El evento que se mandó, como lo recibió su servidor.
delivery*Cómo le fue: ok si contestó 2xx, el código, el error y el inicio de su respuesta.
curl -X POST 'https://api.fiscalisto.com/v1/webhook_endpoints/string/test' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "type": "invoice.failed"}'{ "object": "webhook_test", "event": { "id": "evt_0PKhIdhYuAGwzmMQYfkc", "object": "event", "type": "invoice.stamped", "api_version": "2026-10-24", "livemode": false, "created_at": "2026-10-24T10:15:42-06:00", "data": { "object": { "id": "inv_OufpKqnrvx9p28SINJVjjWKYRhojBTJb8P", "object": "invoice", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "branch": null, "type": "I", "status": "valid", "uuid": "5F1E8C2A-3B7D-4C9E-A1B2-C3D4E5F60718", "series": null, "folio": "1", "date": "2026-10-24T10:15:42", "customer": { "tax_id": "ICV060329BY0", "legal_name": "INMOBILIARIA CVA", "tax_system": "601", "zip": "33826" }, "use": "G03", "payment_form": "03", "payment_method": "PUE", "currency": "MXN", "exchange_rate": null, "items": [ { "description": "Consultoría", "product_key": "80101500", "unit_key": "E48", "unit_name": "Unidad de servicio", "quantity": 1, "unit_price": 1000, "taxability": "02", "iva": "0.16" } ], "subtotal": 1000, "discount": 0, "taxes": { "iva": 160, "ieps": 0, "iva_withheld": 0, "isr_withheld": 0, "local_transferred": 0, "local_withheld": 0 }, "total": 1160, "payment_status": "paid", "amount_due": 0, "amount_paid": 1160, "related": null, "cancellation": null, "email": null, "error": null, "recurring_invoice": null, "created_at": "2026-10-24T10:15:42-06:00", "metadata": {} } } }, "delivery": { "ok": true, "status": 200, "error": null, "response_body": "{\"received\":true}", "duration_ms": 182 }}