Wealth2B

Documentación

Introducción a la API

Swagger↗

Resumen de cobertura

9 dominios

87 endpoints de la API

Documentación API institucional

Guía de integración de API Wealth2B

Esta documentación está pensada para estimar, diseñar y ejecutar integraciones de nivel industria. El contrato técnico siempre sigue Swagger; esta guía explica decisiones de producto, operación y arquitectura.

Flujo de punta a punta
Onboarding, fondeo, activación de producto, trading y liquidaciones.
Robo Advisor en profundidad
Basado en tu documentación ad hoc y las rutas oficiales de Swagger.
Catálogo completo de endpoints
Catálogo completo para alcance técnico y estimación.

Inicio rápido

Camino recomendado para un primer release de integración sin deuda de arquitectura.

1) Auth
JWT setup y control de permisos en staging.
POST /auth/login
GET /auth/profile
2) People + Opening
Onboarding y readiness de cuenta.
POST /people
POST /people/documents
GET /people/{id}/validate
POST /accounts
3) Funding
Depósitos/retiros y transferencias internas.
POST /bank-accounts
POST /money-movements
POST /internal-transfers
4) Product Activation
Robo/Trading + operación y reconciliación.
POST /robo-advisor/associations
POST /trading/orders
GET /settlements/search

Apertura de cuenta y readiness de KYC

Basado en 'Flujo y condiciones para la apertura de cuentas', consolidado con Swagger.

Puerta de readiness
Usa GET /people/{id}/validate como control técnico para habilitar la apertura de cuenta.
Condiciones de apertura

1. People aprobado (estado y reglas en orden).

2. Documentación completa (ID + selfie + POA cuando aplica).

3. KYC verification (owner-of-kyc o gestionado).

4. KYC raw (cuando aplica owner-of-kyc).

Estados comunes: APPROVED / REVIEW / REJECTED (persona), ADDED / OPEN (cuenta).
Endpoints críticos

Robo Advisor en profundidad

Rediseñado sobre la guía ad hoc que compartiste, con exactitud de endpoints basada en Swagger.

Perfilamiento de riesgo (3 caminos)

Directo

GET /robo-advisor/funds/by-risk-level?level=3

Por horizonte

GET /robo-advisor/funds/by-horizon?months=48

Por objetivo

GET /robo-advisor/funds/by-objective?objective=balanced

Funding

POST /bank-accounts

POST /money-movements

POST /internal-transfers

Trading

POST /trading/orders

GET /trading/orders/orders/{id}

POST /trading/orders/accounts/{accountId}/orders/{id}/cancel

Settlements

GET /settlements/search

POST /settlements/{id}/confirm

POST /settlements/{id}/reconcile

Catálogo de endpoints (Swagger)

Catálogo consolidado por dominio para planificación técnica. Los payloads, schemas y ejemplos exhaustivos se mantienen en Swagger.

Guía de estimación de integración

Checklist de ingeniería para estimar esfuerzo, riesgos y dependencias operativas.

Frontend + Product Scope

• ¿Implementas owner-of-kyc o kyc-as-a-service?

• ¿Necesitas Robo Advisor con múltiples objetivos/cofres?

• ¿La UI incluye datos de mercado en tiempo real y trading?

• ¿Necesitas descarga de documentos y reportes para usuarios finales?

Backend + Ops Scope

• Gestión de estados y transiciones (people/account/movement/settlement).

• Manejo asíncrono (webhooks, polling, retries, idempotencia).

• Conciliación de settlements y excepciones.

• Monitoreo operativo y alertas.