Interfaces
API REST
Endpoints de wallet y cards para tu backend.
La API REST cubre dos dominios: wallet (/api/v1/wallet/*) y cards
(/api/card/v1/*). Se autentica con la sesión del usuario (ver
Autenticación).
Wallet — /api/v1/wallet
| Método · Ruta | Descripción |
|---|---|
GET / | Wallet + balance |
GET/POST /sub-wallets | Lista / crea agentes |
GET/PATCH/DELETE /sub-wallets/{id} | Detalle / edita / cierra un agente |
POST /sub-wallets/{id}/allocate | Reasigna cap |
GET/POST /sub-wallets/{id}/keys | Lista / crea agent keys |
POST /sub-wallets/{id}/keys/{keyId}/rotate | Rota una key (24h gracia) |
DELETE /sub-wallets/{id}/keys/{keyId} | Revoca una key |
GET/POST /payees, .../{id} | Destinatarios |
GET/POST /scheduled, .../{id} | Pagos programados |
POST /withdraw · GET /fund-info · POST /fund | Retiro / fondeo |
GET /history · POST /reconcile | Movimientos / conciliación |
Cards — /api/card/v1
| Método · Ruta | Descripción |
|---|---|
GET /cardholders/me | Cardholder del usuario |
POST /kyc/start · GET /kyc/status | KYC (widget de verificación) |
GET/POST /cards | Lista / emite cards |
GET /cards/{id} · .../details · .../reveal · .../share | Detalle y datos sensibles |
Los montos en REST son enteros en centavos. Las respuestas de colección devuelven
{ "data": [...] }; los errores, { "error": "..." } con el código HTTP. Ver
Errores.
La API REST asume sesión hoy — no hay bearer token público por endpoint. El acceso con token vive en el MCP.