Cómo integra un desarrollador la API en treinta minutos
Autenticación, primer expediente y el webhook. El camino más corto a algo que funcione.

Antes de empezar necesitas
- Una API key del entorno de pruebas
- El SDK instalado o un cliente HTTP
- Un endpoint tuyo donde recibir el webhook
-
Empieza en el entorno de pruebas
Hay sandbox por organización. Integrar contra producción desde el primer intento es cómo se ensucian los datos reales.
-
Autentica y lee algo antes de escribir nada
Un listado de expedientes confirma que la key funciona y qué permisos tiene, sin efectos secundarios.
-
Crea un expediente de prueba con el SDK
El SDK de TypeScript evita escribir el cliente HTTP y los reintentos a mano.
-
Monta el webhook antes de necesitarlo
Recibir «documento validado» es lo que evita tener que preguntar cada cinco minutos si llegó.
-
Verifica la firma del webhook
Un endpoint que acepta cualquier POST es un endpoint que acepta el POST de cualquiera.
-
Implementa el reintento desde el principio
Si tu servicio está caído cuando llega el evento, tiene que poder recuperarlo. Un evento perdido en silencio se descubre tarde.
-
Pasa a producción con una key nueva
No reutilices la de pruebas. Y con los permisos mínimos que necesite la integración.
Los errores que más lo devuelven
Datos reales ensuciados y difíciles de limpiar.
Cualquiera puede llamarlo.
Los eventos perdidos se descubren cuando ya importan.
Preguntas frecuentes
¿Dónde está la documentación?
¿Hay límites de uso?
Procedimiento revisado el . Las normas cambian: si el sistema oficial no se parece a lo que lees aquí, manda la pantalla del sistema.
Cuando cambie algo de este trámite, te avisamos
Una vez al mes: qué obligación entra en vigor, a quién afecta y qué hay que empezar a pedir. Nada más.
Y si lo que quieres es que esto ocurra solo
Pedir el documento, insistir por el canal que el otro sí contesta, leerlo, comprobar que cuadra y dejarlo demostrable: es exactamente lo que hace Code Contract. Sin que la otra parte se registre en nada.
Programar una demo de 30 minutos