Swaggers

Contratos publicados

Swaggers del Sistema de Finanzas Abiertas

Los contratos OpenAPI que la plataforma publica. Esta página dice cuál es cuál, a quién sirve cada uno y en qué orden conviene leerlos.

Contratos8
FormatoOpenAPI 3
IdiomaEspañol (Chile)

01 Antes de elegir: los dos saltos

Los ocho contratos no viven en el mismo plano. Distinguirlos evita la confusión más cara de la integración.

SALTO REGULADO Entre participantes del SFA La forma la fija la CMF: la ruta, la envoltura, la paginación y los errores no son elección de la plataforma. El llamador es otro participante.
SALTO DE PLATAFORMA Entre la plataforma y su aplicación Contrato propio de la solución. Existe para que su aplicación intercambie JSON y no tenga que implementar el perfil de seguridad del SFA.
Cómo reconocerlo

Si el contrato dice que su forma sigue la especificación publicada por la CMF, es el salto regulado. Si describe una fachada que la plataforma expone a su aplicación, es el salto de plataforma.

02 El catálogo

ContratoPara quiénSaltoQuién llama
Jornada IPI Aplicación de la institución transmisora (IPI) Plataforma Su aplicación
Jornada PSBI Aplicación del PSBI Plataforma Su aplicación
Consumo de Datos Aplicación del PSBI con consentimiento vigente Plataforma Su aplicación
Recursos PSBI con consentimiento vigente Regulado Otro participante
Webhook de Consentimiento Backend de la institución Plataforma La plataforma
OIDC / OAuth Quien integra directamente con el Authorization Server Regulado Otro participante
Grant Management PSBI / PSIP que gestiona el ciclo de vida del consentimiento Regulado Otro participante
Clients Registro y administración de clientes OIDC Interno Administración
Atención

El Webhook de Consentimiento es el único contrato en que la plataforma es el llamador y su sistema el servidor. Lo que usted publica es el callback; lo que registra es su URL.

03 Por dónde empezar, según su rol

Institución transmisora — IPI / IPC

  1. Jornada IPI
    La pantalla de consentimiento y el Panel de Control del titular. Es el contrato que su aplicación consume.
  2. Webhook de Consentimiento
    Los cambios de estado posteriores a la jornada llegan por aquí. Exponga el callback antes de salir a producción.
  3. Recursos
    El listado que la plataforma sirve en su nombre. Su aplicación no participa de esa llamada, pero el inventario que declara la alimenta.
  4. Interceptors
    Si publica APIs reguladas propias, los tres interceptors son lo que las protege.

Proveedor de servicios — PSBI / PSIP

  1. Jornada PSBI
    La fachada que la plataforma le expone. Con ella no necesita implementar PAR, RAR ni Grant Management por su cuenta.
  2. Consumo de Datos
    Con el grantId en la mano, es como lee las cuentas, tarjetas, créditos e inversiones del titular. La plataforma habla FAPI 2.0 por usted.
  3. Recursos
    El contrato regulado que consumirá una vez que el consentimiento esté vigente.

Integración directa con el Authorization Server

Si prefiere hablar el protocolo del SFA por su cuenta, en lugar de usar la fachada de jornada.

  1. OIDC / OAuth
    Discovery, DCR, PAR, autorización y token, con las extensiones del SFA.
  2. Grant Management
    Consultar, auditar y revocar consentimientos por grant_id.
Dos contratos en inglés

Estos dos documentos están redactados en inglés, a diferencia del resto del catálogo. Su traducción está pendiente.

04 Dónde está la norma

Estos contratos implementan el Sistema de Finanzas Abiertas, pero no lo definen. La autoridad sobre las reglas — perfil de seguridad, principios de diseño, Directorio de Participantes, requerimientos no funcionales — es el portal del desarrollador de la Comisión para el Mercado Financiero.

Portal del desarrollador CMF — Finanzas Abiertas Chile

← Volver a Open Finance Chile