Docs · Referencia

Transacciones

Transacciones registradas y pendientes, del libro mayor y de tarjeta, de la más reciente a la más antigua.

Listar las transacciones registradas

GET/v1/transactions

Transacciones del libro mayor y de tarjeta, ordenadas por fecha, de la más reciente a la más antigua, y luego por un desempate único. Los ids de categoría pueden cambiar durante la beta cerrada, así que no los guardes como claves.

Autenticación

Token bearer cuyo cliente tiene el scope transactions:read

Parámetros

cursorquery · string

El next_cursor de la página anterior. Es opaco: no lo construyas ni lo modifiques

limitquery · integer

Filas por página

mín. 1 · máx. 100 · por defecto 50

fromquery · string

Fecha más antigua, incluida

date

toquery · string

Fecha más reciente

date

directionquery · string

Solo créditos o solo débitos

Uno de creditdebit

mediumquery · string

Solo un medio de pago, como ach, card, check o wire

card_idquery · string

Solo las transacciones de esta tarjeta

category_idquery · string

Solo las transacciones de esta categoría

qquery · string

Texto de búsqueda: solo letras, dígitos, espacios y puntos. Cualquier otra cosa devuelve un 400

máx. 30 caracteres · patrón ^[a-zA-Z0-9. ]*$

Respuesta · una lista de Transaction

dataarray of Transaction

La página de resultados

next_cursorstring or null

Pásalo como cursor para obtener la página siguiente. null en la última página

Cada elemento de data:

idstringobligatorio

El id de la transacción

datestringobligatorio

Fecha de la transacción

date

amountMoneyobligatorio

Importe movido

amount.amountstringobligatorio

Cadena decimal con dos decimales, nunca negativa. El campo direction indica en qué sentido se movió

patrón ^[0-9]+\.[0-9]{2}$

amount.currencystringobligatorio

Siempre USD

Uno de USD

directionstringobligatorio

Dinero que entra (credit) o que sale (debit)

Uno de creditdebit

mediumstringobligatorio

Medio de pago, como ach, card, check o wire

statusstringobligatorio

Estado de la transacción

descriptionstringobligatoriotexto no confiable

Descripción del comercio, el pagador o el banco

counterpartyobject

Quién estaba del otro lado

counterparty.namestringtexto no confiable

Nombre del comercio o del beneficiario

categoryCategoryRef

Categoría de la transacción

category.idstring

El id de la categoría. Puede cambiar durante la beta cerrada

category.namestringtexto no confiable

El nombre de la categoría. No confiable cuando la creó el titular

notesstringtexto no confiable

Nota añadida en Novo

reference_numberstring

Número de referencia

check_numberstring

Número de cheque, para cheques

cardobject

La tarjeta usada, para transacciones con tarjeta

card.idstring

El id de la tarjeta

card.last_fourstring

Últimos 4 dígitos de la tarjeta

Respuestas

200OK
401Falta el token, venció o es desconocido, o el cliente se revocó o se desactivó
403Al cliente le falta el scope, la situación del titular cambió o la API no está habilitada para este negocio
429Demasiadas solicitudes. Espera lo que indique Retry-After
500Algo falló de forma inesperada del lado de Novo. No se puede reintentar: menciona request_id a soporte
503Algo de lo que depende la respuesta no está disponible. Reintenta después de Retry-After

Solicitud

curl "https://$NOVO_API_HOST/v1/transactions" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Respuesta · 200

{
  "data": [
    {
      "id": "txn_example_01",
      "date": "2026-10-01",
      "amount": {
        "amount": "84.20",
        "currency": "USD"
      },
      "direction": "debit",
      "medium": "card",
      "status": "EXAMPLE_STATUS",
      "description": "EXAMPLE MERCHANT",
      "counterparty": {
        "name": "Example Merchant"
      },
      "category": {
        "id": "cat_example_01",
        "name": "Supplies"
      },
      "card": {
        "id": "00000000-0000-4000-8000-000000000001",
        "last_four": "4321"
      }
    }
  ],
  "next_cursor": null
}

Listar las transacciones pendientes

GET/v1/transactions/pending

Transacciones que todavía no se han registrado. Cada página tiene como máximo 100 filas. La contraparte es solo un nombre. Si una parte de la lista no se puede cargar, recibes un 503 con Retry-After, nunca una página incompleta. Una página es una instantánea; un recorrido por muchas páginas no lo es.

Autenticación

Token bearer cuyo cliente tiene el scope transactions:read

Parámetros

cursorquery · string

El next_cursor de la página anterior. Es opaco: no lo construyas ni lo modifiques

limitquery · integer

Filas por página

mín. 1 · máx. 100 · por defecto 50

Respuesta · una lista de PendingTransaction

dataarray of PendingTransaction

La página de resultados

next_cursorstring or null

Pásalo como cursor para obtener la página siguiente. null en la última página

Cada elemento de data:

idstringobligatorio

El id de la transacción pendiente

amountMoneyobligatorio

Importe

amount.amountstringobligatorio

Cadena decimal con dos decimales, nunca negativa. El campo direction indica en qué sentido se movió

patrón ^[0-9]+\.[0-9]{2}$

amount.currencystringobligatorio

Siempre USD

Uno de USD

directionstringobligatorio

Dinero que entra (credit) o que sale (debit)

Uno de creditdebit

mediumstringobligatorio

Medio de pago

descriptionstringobligatoriotexto no confiable

Descripción del comercio, el pagador o el banco

counterpartyobject

Quién está del otro lado

counterparty.namestringtexto no confiable

Nombre del comercio o del beneficiario

expected_onstring

Fecha en que se espera que llegue

date

check_numberstring

Número de cheque, para cheques

Respuestas

200OK
401Falta el token, venció o es desconocido, o el cliente se revocó o se desactivó
403Al cliente le falta el scope, la situación del titular cambió o la API no está habilitada para este negocio
429Demasiadas solicitudes. Espera lo que indique Retry-After
500Algo falló de forma inesperada del lado de Novo. No se puede reintentar: menciona request_id a soporte
503Algo de lo que depende la respuesta no está disponible. Reintenta después de Retry-After

Solicitud

curl "https://$NOVO_API_HOST/v1/transactions/pending" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Respuesta · 200

{
  "data": [
    {
      "id": "ptx_example_01",
      "amount": {
        "amount": "400.00",
        "currency": "USD"
      },
      "direction": "credit",
      "medium": "ach",
      "description": "EXAMPLE PAYER PAYMENT",
      "counterparty": {
        "name": "Example Payer"
      },
      "expected_on": "2026-10-03"
    }
  ],
  "next_cursor": null
}

Obtener una transacción registrada

GET/v1/transactions/{transaction_id}

El mismo objeto de transacción que en la lista.

Autenticación

Token bearer cuyo cliente tiene el scope transactions:read

Parámetros

transaction_idpath · stringobligatorio

El id de la transacción

Respuesta · Transaction

idstringobligatorio

El id de la transacción

datestringobligatorio

Fecha de la transacción

date

amountMoneyobligatorio

Importe movido

amount.amountstringobligatorio

Cadena decimal con dos decimales, nunca negativa. El campo direction indica en qué sentido se movió

patrón ^[0-9]+\.[0-9]{2}$

amount.currencystringobligatorio

Siempre USD

Uno de USD

directionstringobligatorio

Dinero que entra (credit) o que sale (debit)

Uno de creditdebit

mediumstringobligatorio

Medio de pago, como ach, card, check o wire

statusstringobligatorio

Estado de la transacción

descriptionstringobligatoriotexto no confiable

Descripción del comercio, el pagador o el banco

counterpartyobject

Quién estaba del otro lado

counterparty.namestringtexto no confiable

Nombre del comercio o del beneficiario

categoryCategoryRef

Categoría de la transacción

category.idstring

El id de la categoría. Puede cambiar durante la beta cerrada

category.namestringtexto no confiable

El nombre de la categoría. No confiable cuando la creó el titular

notesstringtexto no confiable

Nota añadida en Novo

reference_numberstring

Número de referencia

check_numberstring

Número de cheque, para cheques

cardobject

La tarjeta usada, para transacciones con tarjeta

card.idstring

El id de la tarjeta

card.last_fourstring

Últimos 4 dígitos de la tarjeta

Respuestas

200OK
401Falta el token, venció o es desconocido, o el cliente se revocó o se desactivó
403Al cliente le falta el scope, la situación del titular cambió o la API no está habilitada para este negocio
404No hay nada con ese id en el negocio vinculado
429Demasiadas solicitudes. Espera lo que indique Retry-After
500Algo falló de forma inesperada del lado de Novo. No se puede reintentar: menciona request_id a soporte
503Algo de lo que depende la respuesta no está disponible. Reintenta después de Retry-After

Solicitud

curl "https://$NOVO_API_HOST/v1/transactions/txn_example_01" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Respuesta · 200

{
  "id": "txn_example_01",
  "date": "2026-10-01",
  "amount": {
    "amount": "84.20",
    "currency": "USD"
  },
  "direction": "debit",
  "medium": "card",
  "status": "EXAMPLE_STATUS",
  "description": "EXAMPLE MERCHANT",
  "counterparty": {
    "name": "Example Merchant"
  },
  "category": {
    "id": "cat_example_01",
    "name": "Supplies"
  },
  "card": {
    "id": "00000000-0000-4000-8000-000000000001",
    "last_four": "4321"
  }
}

Previsto para transacciones

Añadir notas y categorías

Todavía no está disponible, y no se publica ningún endpoint para esto. Aparecerán aquí cuando el contrato los defina. Todo lo marcado como “requiere tu aprobación” espera a que el titular de la cuenta lo apruebe en su teléfono, cada vez. Dinos qué necesitas primero cuando pidas tu lugar.