Servicios de integración API para Fiwind — OpenFinance, CVU e inversiones

Inicio de sesión y sesión autorizados

Replicamos el flujo de login de Fiwind bajo autorización del usuario: teléfono/email + OTP, huella de dispositivo y rotación de refresh tokens. Nuestro wrapper devuelve un bearer de corta duración para que los servicios downstream (CRM, ERP, tableros KYC) llamen a otros endpoints sin tocar credenciales del usuario.

API de historial de transacciones

Movimientos paginados en pesos, dólares y cripto, con filtros por rango de fechas, moneda (ARS/USD/BRL/USDC/BTC/ETH), contraparte y tipo de operación (depósito, retiro, swap, pago, acreditación de rendimiento). Útil para conciliación diaria, declaraciones impositivas y controles antifraude.

Exportación de portafolio de inversiones

Resolvemos las tenencias de CEDEAR y ADR a un esquema normalizado: ISIN/ticker, ratio, costo promedio, precio de mercado actual, P&L realizado y no realizado. Alimenta herramientas de tesorería y tableros para inversores que antes parseaban PDFs de extractos.

Cotizaciones FX y stablecoins

Streaming de precios de compra/venta de Fiwind para ARS/USD, USDC, USDT, BRL y las principales criptos. Ideal para tesorerías que cotizan facturas internacionales o para construir monitores de arbitraje entre dólar MEP y dólar cripto.

Pix y transferencias internacionales

Capturamos pagos Pix entrantes/salientes (BRL), tramos ACH y Wire en USD con metadatos IBAN/SWIFT/routing, además de ingresos de Payoneer, PayPal, Wise y Airbnb. Cada registro lleva un external_id estable para que los sistemas downstream puedan deduplicar.

Tarjeta y pago de servicios

Extracción de las autorizaciones de la tarjeta gratuita Fiwind, los tokens de Apple Pay / Google Pay y los más de 5.000 servicios de pago disponibles (servicios públicos, impuestos, recargas de celular). Útil para agregadores de finanzas personales y productos de gestión de gastos para PyMEs.

1 · Contabilidad de freelancers y exportadores (AR + BR)

Contexto: diseñadores y desarrolladores argentinos cobran USD por ACH/Wire desde Payoneer, Wise y Airbnb, mientras que los clientes brasileños pagan en BRL vía Pix. En cada cierre, descargan PDFs de Fiwind a mano.

Flujo: nuestro wrapper invoca /transactions con currency=USD,BRL, mapea cada ingreso a una factura y lo empuja a Alegra/Colppy/Xero. Se preserva fx.applied_rate para que los reportes ante AFIP/ARCA usen la tasa efectiva real, no una teórica.

Ángulo OpenFinance: alineado con el Decreto 353/2025 y el régimen de consentimiento del usuario — la persona autoriza al ERP del exportador a leer sólo lectura sus movimientos de Fiwind.

2 · Tablero de tesorería para PyMEs multimoneda

Contexto: una PyME mantiene caja operativa en ARS (con rendimiento diario), USD (para proveedores) y USDC (para contrapartes fuera de Argentina). Finanzas necesita una vista única entre wallets y contrapartes.

Flujo: /balances consultado cada 30 segundos + /fx/quotes alimentan un panel de tesorería en streaming; /transactions?type=swap nutre los gráficos de P&L FX realizado.

Ángulo OpenFinance: patrón canónico de "Account Information Services" de Open Banking, adaptado al mercado argentino de billeteras fintech.

3 · Agregador de portafolios CEDEAR / ADR

Contexto: inversores minoristas distribuyen posiciones de CEDEAR entre Fiwind y otro broker. Quieren costo base consolidado y lotes impositivos para el cierre fiscal.

Flujo: /investments/holdings + /investments/trades devuelven ticker, ratio, costo promedio y lotes ejecutados; nuestro normalizador calcula la equivalencia entre el ratio del CEDEAR y el ADR subyacente para que los agregadores muestren una única posición.

Ángulo OpenFinance: la portabilidad de datos de inversión está prevista en las pautas de la CNV (Comisión Nacional de Valores) y se espera bajo la próxima normativa de Open Finance del BCRA.

4 · SaaS de gestión de gastos para PyMEs

Contexto: un equipo entrega tarjetas Fiwind gratuitas a sus colaboradores para viajes y gasto operativo; finanzas necesita gasto por persona, categorización por MCC y conciliación con comprobantes.

Flujo: el webhook /cards/authorizations envía consumos en tiempo real (comercio, monto, MCC) al SaaS; /cards/statements produce resúmenes de fin de mes. Los tokens de Apple Pay / Google Pay se marcan para distinguir uso físico vs. digital en la analítica.

Ángulo OpenFinance: reproduce el test de cobertura del Artículo 67 de PSD2 ("Card Based Payment Instrument Issuer"), adaptado a los rieles de tarjeta argentinos.

5 · Cumplimiento y monitoreo de riesgo para flujos cripto

Contexto: un PSAV (Proveedor de Servicios de Activos Virtuales) integrado con Fiwind necesita screening transaccional, metadatos de Travel Rule y alertas de anomalías sobre movimientos USDC/BTC/ETH.

Flujo: /crypto/transfers expone red, hash de la transacción, dirección de la contraparte, monto y equivalente fiat. Lo conectamos a scoring estilo Chainalysis/Elliptic y elevamos las marcas de riesgo al equipo de operaciones.

Ángulo OpenFinance: sirve a las obligaciones de reporte de la Resolución General CNV 994/2024 (registro de PSAVs).

Inicio de sesión autorizado (wrapper estilo OAuth)

POST /api/v1/fiwind/auth/login
Content-Type: application/json

{
  "credentials_ref": "vault://fiwind/user/42",
  "device_id": "web-desk-01",
  "otp": "394211",
  "scope": ["balances","transactions","investments"]
}

200 OK
{
  "access_token": "eyJ...",
  "refresh_token": "rfw_...",
  "expires_in": 900,
  "cvu": "0000003100091212345678",
  "user_ref": "fiw_42"
}

Consulta de extracto — multimoneda

POST /api/v1/fiwind/transactions
Authorization: Bearer <ACCESS_TOKEN>

{
  "cvu": "0000003100091212345678",
  "from_date": "2026-03-01",
  "to_date":   "2026-03-31",
  "currencies": ["ARS","USD","USDC","BRL"],
  "types": ["deposit","withdrawal","swap","payment","yield_credit"],
  "cursor": null,
  "limit": 100
}

200 OK
{
  "items": [
    {
      "id": "fwtx_01J...",
      "ts": "2026-03-14T18:02:11Z",
      "currency": "USD",
      "amount": 250.00,
      "type": "deposit",
      "rail": "ACH",
      "counterparty": {"name":"Payoneer","ref":"PAY-88421"},
      "fx": {"base":"USD","quote":"ARS","applied_rate":1042.55}
    }
  ],
  "next_cursor": "c2Vla19ub19tb3Jl"
}

Operaciones y tenencias de inversión

GET /api/v1/fiwind/investments/holdings
Authorization: Bearer <ACCESS_TOKEN>

200 OK
[
  {
    "symbol": "AAPL",
    "instrument": "CEDEAR",
    "ratio": "20:1",
    "quantity": 40,
    "avg_cost_ars": 4523.11,
    "market_price_ars": 5110.44,
    "unrealized_pl_ars": 23489.20
  },
  {
    "symbol": "MSFT",
    "instrument": "CEDEAR",
    "ratio": "10:1",
    "quantity": 25,
    "avg_cost_ars": 6210.00,
    "market_price_ars": 6680.00,
    "unrealized_pl_ars": 11750.00
  }
]

Webhook de autorización de tarjeta

POST https://your-app/webhook/fiwind/cards
X-Fiwind-Signature: t=1713799211,v1=ab7f9a...

{
  "event": "card.authorization",
  "card_ref": "fwcd_77",
  "merchant": {"name":"MercadoLibre","mcc":"5999","country":"AR"},
  "amount": {"value": 45990, "currency":"ARS"},
  "wallet": "google_pay",
  "status": "approved",
  "ts": "2026-04-22T13:15:07Z"
}

// Verificá la firma con HMAC-SHA256(secret, t + "." + body)
// Rechazá si |now - t| > 300s para evitar replay

Checklist de entregables

• Especificación OpenAPI 3.1 para todos los endpoints envueltos de Fiwind
• Reporte del flujo de protocolo y autorización (login, OTP, refresh de token, esquema de firma)
• Código fuente ejecutable en Python (FastAPI) y/o Node.js (NestJS), con Docker Compose
• Utilidad de verificación de webhooks (HMAC-SHA256, protección anti-replay)
• Colección Postman y tests de integración (pytest / Jest)
• Notas de cumplimiento mapeadas al Decreto 353/2025, Ley 25.326 y CNV RG 994/2024
• Runbook operativo: rate limits, estrategia de backoff, rotación de tokens, respuesta a incidentes

Modelos de contratación

Desde USD 300 Entrega de código fuente — Entregamos código ejecutable y documentación completa; pagás después de la entrega y según conformidad.

Pago por consumo API gestionada — Usá nuestros endpoints administrados y pagá sólo por llamada exitosa; sin costo inicial. Ideal para equipos que prefieren precio por uso y delegar la operación.

Disponibles esquemas a medida para empresas, incluyendo despliegue on-prem, SSO y mapeo de campos a medida hacia ERP/pipelines impositivos.

Sobre nosotros

Somos un estudio de ingeniería independiente enfocado en análisis de protocolo de fintechs móviles y entrega de APIs estilo OpenFinance. Nuestro equipo ha desplegado integraciones para gateways de pago, billeteras digitales, brokers y plataformas cripto en América Latina, Europa y el sudeste asiático, y trabaja habitualmente bajo NDA con clientes corporativos que necesitan pipelines de datos autorizados y listos para cumplimiento.

• Reverse engineering móvil y análisis de protocolo autorizado (Android + iOS)
• Gateways API empresariales, SSO y gestión granular de consentimiento
• SDKs Python / Node.js / Go a medida, clientes tipados y harnesses de testing
• Punta a punta: scoping → análisis de protocolo → build → QA → cumplimiento
• Dos modelos de contratación: entrega de código desde USD 300, o API gestionada por consumo

Contacto

Mandanos el nombre de la app objetivo (en tu caso, Fiwind) y los datos que necesitás — saldos, transacciones, inversiones, flujos Pix o el stack completo. Respondemos con un estimado de scope y un payload de muestra dentro del próximo día hábil.

Abrir página de contacto

Flujo de trabajo del proyecto

1. Confirmación de scope — qué módulos de Fiwind importan (CVU, inversiones, Pix, tarjetas) y qué sistemas downstream consumen los datos.
2. Análisis de protocolo y diseño de la API (2 a 5 días hábiles según el alcance).
3. Build y validación interna (3 a 8 días hábiles) con credenciales de sandbox.
4. Documentación, colección Postman y tests automatizados (1 a 2 días hábiles).
5. Primera entrega típica: 5 a 15 días hábiles. Más largo si hay revisión de cumplimiento multirregional.

Preguntas frecuentes

¿Qué necesitás de mi parte?

¿Cuánto tarda la entrega?

¿Cómo manejan el cumplimiento?

¿Pueden combinar Fiwind con otras billeteras?