Versiones y changelog
Esta página te dice cómo cambia la documentación y qué sigue abierto. Lo segundo es lo importante para ti: si algo de la API todavía está por confirmar con SPIDI, aquí lo ves claro — y por qué no te bloquea para construir hoy.
Cómo versionamos
La documentación de este portal se apoya en dos fuentes de verdad:
- El contrato OpenAPI de cada API. La sección Referencia (endpoints, campos, códigos) se auto-genera desde ahí: cuando SPIDI actualiza el contrato, la Referencia se actualiza sola.
- El simulador, que implementa ese contrato de punta a punta. Las guías y el tutorial se verifican corriendo contra el simulador, así que el código que lees aquí es código que pasa.
Por eso no encontrarás un número de versión "v1.3.2" de la documentación: el contenido vive con el contrato y con el simulador. Lo que sí registramos abajo son los cambios estructurales del portal y las brechas que seguimos cerrando con SPIDI.
Historial del portal
| Fecha | Cambio |
|---|---|
| 2026-06 | Primera publicación: Empezar aquí, Productos (conceptos + guías), Recursos (diccionario de datos, entornos, estados y errores, simulador) y el esqueleto de Merchant. |
A medida que se publique contenido nuevo (guías de Merchant, plugins) lo verás reflejado aquí.
Brechas conocidas
Estas son las cosas que aún se confirman con SPIDI. Ninguna te frena: construyes contra el contrato y pruebas contra el simulador, que ya resuelve cada caso por diseño. Solo importan para la fidelidad en producción, y eso se reconcilia con SPIDI antes de salir en vivo.
URL base de producción — por confirmar
El contrato declara hoy la URL de sandbox; falta que SPIDI agregue la de producción. Mientras tanto desarrollas contra el simulador y el sandbox sin cambiar tu código: solo cambia la URL base cuando llegue el dato. → Entornos y URLs.
Firma de los avisos (webhooks) — detalle por confirmar
El método de firma está documentado y el simulador firma cada aviso con él: cabeceras spidi-signature + spidi-timestamp (HMAC-SHA256). Lo que se afina con SPIDI es el detalle fino — qué se firma exactamente y el texto literal del campo event. Si verificas la firma como muestra la guía, ese detalle no te afecta. → Manejar notificaciones.
Expirar una sesión — ruta por confirmar
El simulador implementa la expiración tal como dice el contrato (/expiration, con category) y lo refleja en el status. Una prueba en el entorno en vivo sugirió una ruta distinta; está pendiente confirmar cuál manda en producción y si cambia entre Botón y Solicitud. Tu flujo corre verde contra el simulador. → Estados y contrato de error.
Ruta de login en el contrato — corrección menor pendiente
La descripción del contrato trae una ruta de login equivocada. La ruta buena es la de la tabla de entornos (/api/spidipagos/login para Productos). Es un arreglo barato del lado de SPIDI que se propaga solo al portal. → Entornos y URLs.
El registro completo de discrepancias contrato ↔ sandbox y las peticiones a SPIDI viven en docs/issues-pendientes-api.md del repositorio. Esta página es su resumen en clave de integrador.