FISCALISTO / API / REFERENCIA
Crear una liga de alta
Una página en fiscalisto.com donde el dueño del emisor sube su CSD y firma el contrato con el PAC con su e.firma, sin que esos archivos ni sus contraseñas pasen por su plataforma. Mande a su cliente a url; al terminar vuelve a return_url y llega issuer.ready. Cada liga sirve para un emisor, hasta que vence.
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/json- body
return_url?stringA dónde regresa el botón al terminar, por ejemplo la página de su plataforma donde su cliente sigue. Sin ella, la página solo dice que ya terminó.
urilength <= 2000expires_in_hours?integerHoras que la liga sirve, de 1 a 168 (7 días). Por omisión 24.
1 <= value <= 168Correcto.
application/json- response
Una liga para que el dueño de un emisor suba su CSD y firme con su e.firma.
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.
issuer*stringEl emisor que se da de alta.
url*stringLa página para el dueño del emisor, en fiscalisto.com. Ábrala en el navegador de su cliente; no la incruste en un iframe.
return_url*|A dónde regresa al terminar.
expires_at*|Cuándo deja de servir la liga. Pida otra cuando quiera.
created_at*|Cuándo se creó.
curl -X POST 'https://api.fiscalisto.com/v1/issuers/string/onboarding_links' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "return_url": "https://miplataforma.mx/configuracion/facturas"}'{ "object": "issuer_onboarding_link", "livemode": false, "issuer": "iss_0q1Vmmw52sbD", "url": "https://fiscalisto.com/alta/fko_8Xc1nQ2VbT0aLm3Rk7Yp9WdZs4Hf6Jg5Ue1Oi2Ky", "return_url": "https://miplataforma.mx/configuracion/facturas", "expires_at": "2026-10-25T10:15:00-06:00", "created_at": "2026-10-24T10:15:00-06:00"}