API
Idioma
Pide tu lugar

Beta cerrada. Todavía no se puede llamar a nada. Esta documentación describe el contrato del primer día, y los nombres marcados como propuesto pueden cambiar antes de que abra la beta. Pide tu lugar

Docs · Introducción

Documentación de Novo API

Una API REST para la cuenta corriente empresarial de Novo. Permite que las herramientas y los agentes de IA del titular de la cuenta consulten la cuenta y congelen una tarjeta. Está en beta cerrada: estas páginas documentan el contrato del primer día, y todavía no se puede llamar a nada.

Qué hace la API

Todo lo que está previsto que haga la API, por recurso. Lo que tiene enlace está en la beta cerrada y documentado en la referencia; lo demás está previsto, sin fechas. Todo lo que mueve dinero o cambia a quién se le puede pagar espera a que el titular de la cuenta lo apruebe en su teléfono, cada vez, aunque lo haya pedido un agente.

PrevistoRequiere tu aprobación Requiere tu aprobación

Tokens de acceso

Cuentas

Transacciones

Contabilidad

Tarjetas

Reservas

  • Apartar dinero en reservas

Facturas

  • Guardar borradores de facturas
  • Enviar facturasRequiere tu aprobación

Movimiento de dinero

  • Enviar dinero por ACHRequiere tu aprobación
  • Enviar transferencias bancarias (wire) nacionalesRequiere tu aprobación
  • Pagar y gestionar beneficiariosRequiere tu aprobación

Crédito

  • Ver los saldos y movimientos de la tarjeta de crédito y los préstamos
  • Hacer pagos y cambiar el pago automáticoRequiere tu aprobación

Integraciones

  • Ver qué conexiones están activas

Conectar y desconectar se quedan en la app de Novo.

Soporte

  • Abrir un ticket de soporte y leer sus respuestas

No incluye disputas.

Notificaciones

  • Elegir qué notificaciones recibes

El registro de dispositivos se queda en la app de Novo.

Flujos de trabajo
La API no ejecuta flujos de trabajo por ti. Créalos en tus propias herramientas y agentes sobre ella: los reintentos son seguros con una clave de idempotencia, las acciones que requieren tu aprobación te esperan, y tú consultas el resultado después.
Lo estamos evaluando
Webhooks, un sandbox e inicio de sesión para apps de terceros
Dinos si lo necesitas
Estados de cuenta, exportaciones, pagos programados, nómina y pagos a contratistas, ¿o algo más? Cuéntanos al registrarte.
Nunca a través de la API
Crear credenciales de API fuera de la app de Novo. Acceder a un negocio al que el cliente no está vinculado.

Cómo funciona el acceso

  1. El titular de la cuenta crea un cliente de API en la app de Novo, después de un paso de verificación, y elige sus scopes. Solo el titular puede hacerlo, y cada cliente está vinculado a un negocio.
  2. La app muestra el client secret una sola vez. Tu código cambia el client id y el secret por un token de acceso de corta duración en /v1/oauth/token.
  3. Todas las demás llamadas envían ese token como Authorization: Bearer. El token lleva los scopes que eligió el titular; todo lo que quede fuera se rechaza.
  4. El titular puede revocar el cliente en la app en cualquier momento.

Scopes: accounts:readtransactions:readbookkeeping:readcards:readcards:freeze. Más detalles en Autenticación.

Pensada para que la llame un agente de IA

Un cliente de solo lectura no puede mover dinero. Los errores indican si es seguro reintentar. El texto que escriben comercios, pagadores o el titular se marca como no confiable, para que un agente lo trate como datos y no como instrucciones. Consulta Convenciones y Errores y reintentos.

Sobre esta documentación

Cada ruta, campo y valor de aquí viene del contrato de la beta cerrada (revisión 4). El contrato todavía es una propuesta, así que los nombres pueden cambiar antes de que abra la beta. Los ejemplos usan datos ficticios.