Fiskil Docs

Guía rápida

Lanza tu primera integración de Data Provider — desde el resource server hasta la validación de extremo a extremo — en menos de una hora.

Lanza tu primera integración de Data Provider — desde el resource server hasta la validación de extremo a extremo — en menos de una hora.

Tiempo estimado: 30–60 minutos

Antes de empezar

Para seguir esta guía necesitarás:

  • Acceso a la Consola de Fiskil con permisos de administrador de la organización
  • Un dominio bajo tu control (para la configuración de DNS y marca)
  • Un ingeniero que implemente o simule tu Resource Server

Paso 1 — Aprovisiona tus entornos

Una vez aprobado tu acceso a la plataforma Fiskil Data Provider, aprovisionaremos instancias separadas de Staging y Producción para ti.

Cada instancia está aislada e incluye:

  • Claves específicas del entorno
  • Logs y métricas separados
  • Herramientas de pruebas y sandbox

Usa Staging para todo el desarrollo e integración inicial.

Paso 2 — Implementa un Resource Server mínimo

Tu Resource Server es tu API — Fiskil la llamará después de que un usuario dé su consentimiento.

Para tu primera integración, necesitarás implementar estos tres endpoints:

Endpoints requeridos

EndpointPropósitoReferencia
GET /auth/v1/customer/searchIdentificar al cliente durante el flujo de consentimientoEnlace
GET /auth/v1/customer/{customerId}/accountsListar las cuentas disponibles para compartirEnlace
GET /auth/v1/customer/{customerId}Obtener la información de identidad del clienteEnlace
GET /v1/customer/{customerId}/accounts/{accountId}/balancesEndpoint de ejemplo para exponer datos del cliente

Estos endpoints deben:

  • Ser accesibles por Fiskil Data Provider a través de HTTPS
  • Aceptar tokens Bearer y validarlos usando el JWKS de Fiskil

Para las pruebas iniciales, estos endpoints pueden devolver datos estáticos o simulados.

Ejemplo: endpoint de saldos

curl -H "Authorization: Bearer <ACCESS_TOKEN>" \
  https://<your-resource-server>/v1/customer/{customerId}/accounts/{account_id}/balances

Respuesta de ejemplo:

{
  "account_id": "acc_001",
  "available": 1200.50,
  "current": 1250.75,
  "currency": "AUD"
}

Paso 3 — Vincula tu Resource Server

En la Consola:

  • Establece la URL base de tu Resource Server en la instancia staging
  • (Opcional) Configura una lista de IPs permitidas para restringir el tráfico entrante a las IPs de Fiskil
  • Confirma que tu API es accesible y está operativa

Paso 4 — Configura marca y DNS (opcional)

Personaliza el flujo de consentimiento visible para el usuario con:

  • Tu logotipo y nombre visible
  • Un dominio propio, como consent.yourcompany.com

Para configurarlo, consulta: Configuración de dominio propio

Paso 5 — Ejecuta una prueba de extremo a extremo

Usa las herramientas de pruebas de Fiskil para validar el flujo de consentimiento completo.

Como parte de tu onboarding te invitaremos a nuestras herramientas de pruebas. Estas dependen del tipo de integración que estés construyendo: dentro de un estándar regulatorio o como proveedor de datos voluntario.

Paso 6 — Ve más allá

Una vez validada tu integración:

  • Añade soporte completo para más endpoints y scopes
  • Aplica un perfil de cumplimiento (p. ej., CDR, FDX)
  • Activa logs y métricas. Consulta Logs y Métricas

Paso 7 — Sal a producción

Para lanzar en producción:

  • Completa la certificación o validación regulatoria requerida (si aplica)
  • Registra e incorpora clientes de terceros de confianza (p. ej., Plaid, apps de energía)
  • Apunta las integraciones de producción a tu instancia en vivo

Repaso de conceptos clave

Instancia: un entorno aislado con su propio dominio, claves, logs y configuración.

Resource Server: tu API — expone los datos de los clientes y responde a Fiskil usando contratos estándar.

Scopes y consentimiento: tus clientes deben consentir compartir sus datos. El alcance de ese consentimiento define qué datos pueden compartirse. Fiskil gestiona los Scopes y los Consentimientos.

Perfil de cumplimiento: una plantilla de comportamiento predefinida (cabeceras, scopes, APIs) basada en estándares como CDR o FDX.

IntroducciónInstances