Wealth2B

Documentation

API Introduction

Swagger↗

Coverage Snapshot

9 domains

87 endpoints

Documentacion API institucional

Guia de integracion de API Wealth2B

Esta documentacion esta pensada para estimar, disenar y ejecutar integraciones de nivel industria. El contrato tecnico siempre sigue Swagger; esta guia explica decisiones de producto, operacion y arquitectura.

Flujo de punta a punta
Onboarding, fondeo, activacion de producto, trading y liquidaciones.
Robo Advisor en profundidad
Basado en tu documentacion ad hoc y las rutas oficiales de Swagger.
Catalogo completo de endpoints
Catalogo completo para alcance tecnico y estimacion.

Quickstart

Camino recomendado para un primer release de integracion 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 tecnico 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 criticos

Robo Advisor en profundidad

Redisenado sobre la guia 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

Catalogo de endpoints (Swagger)

Catalogo consolidado por dominio para planificacion tecnica. Los payloads, schemas y ejemplos exhaustivos se mantienen en Swagger.

Integration Estimation Guide

Checklist de ingenieria para estimar esfuerzo, riesgos y dependencias operativas.

Frontend + Product Scope

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

• ¿Necesitas Robo Advisor con multiples 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.