FISCALISTO / API / REFERENCIA
Crear un entorno de prueba
Un modo de pruebas propio para una persona o un proyecto: nace con el emisor de pruebas del SAT y una llave fk_test_ (key.secret, una sola vez) que solo ve los emisores, webhooks y eventos del entorno, y que reinicia solo los suyos. Se crea con una llave de pruebas de la cuenta (no de otro entorno ni limitada a emisores). Hasta 25 por cuenta.
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/json- body
name*stringPara quién o para qué es, por ejemplo el nombre de quien lo usa.
1 <= length <= 60Correcto.
application/json- response
Un entorno de prueba: el modo de pruebas propio de una persona, con su emisor, llaves, webhooks y eventos aparte.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
object*stringQué tipo de objeto es («invoice», «customer»…).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
name*stringNombre.
issuers*integerEmisores activos en el entorno.
-9007199254740991 <= value <= 9007199254740991issuer?|El emisor de pruebas del SAT con que nace (solo al crearlo).
key?Solo al crearlo.
created_at*|Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
deleted?booleanSiempre true.
curl -X POST 'https://api.fiscalisto.com/v1/sandboxes' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "name": "Ana"}'{ "id": "sbx_4kQm8ZtR2wLp9XbN", "object": "sandbox", "livemode": false, "name": "Ana", "issuers": 1, "created_at": "2026-10-25T09:40:00-06:00"}