Obtén estados de cuenta

Un estado de cuenta es un documento PDF mensual que resume todos los movimientos de una cuenta durante un período específico. Los estados de cuenta se generan automáticamente para cada cuenta activa y cumplen con los requisitos regulatorios locales. Puedes listar y descargar los estados de cuenta a través de la API o desde el Dashboard. Los estados de cuenta se generan automáticamente al inicio de cada mes para el período anterior. No requieren ninguna acción de tu parte.

Listar estados de cuenta

Usando el account_id, llama al endpoint List Account Statements. Puedes listar todos los estados de cuenta de la cuenta o filtrar por un período de tiempo específico.

curl --request GET \
     --url 'https://api.fintoc.com/v2/accounts/acc_3AOIA4Hz09oHLeksYr9pYpBk3NS/account_statements?since=2026-03-01&until=2026-03-31' \
     --header 'Authorization: sk_test_14ucwLs17VyE5XKFxMb3x8sHwPeSrGVh6hvVayzoi8Q' \
     --header 'accept: application/json'

Node SDK

const statements = await client.v2.accounts.accountStatements.list({
  account_id: "acc_3AOIA4Hz09oHLeksYr9pYpBk3NS",
  since: "2026-03-01",
  until: "2026-03-31",
});

Python SDK

statements = client.v2.accounts.account_statements.list(
    account_id="acc_3AOIA4Hz09oHLeksYr9pYpBk3NS",
    since="2026-03-01",
    until="2026-03-31",
)

Response

[
  {
    "id": "acst_8sFkj2mNpQ4rTvWx6yZ1bC3d",
    "object": "account_statement",
    "period": "2026-03",
    "since": "2026-03-01",
    "until": "2026-03-31",
    "download_url": "https://files.fintoc.com/account_statements/acst_8sFkj2mNpQ4rTvWx6yZ1bC3d.pdf?signature=000000000000",
    "created_at": "2026-04-01T00:00:00Z"
  }
]

Descargar el PDF

El campo download_url contiene una URL firmada. Realiza una solicitud GET a esa URL para descargar el archivo PDF directamente. La URL firmada expira. Si ya expiró, vuelve a listar los estados de cuenta para obtener una URL nueva. El estado de cuenta descargado se ve así:

Probar la integración

En modo test, lista los estados de cuenta de la cuenta y abre el download_url de cualquier elemento de la respuesta. La URL firmada devuelve el PDF del estado de cuenta directamente en tu navegador. Si el PDF se abre, la integración funciona de extremo a extremo.

Inicio

Recursos

Pagos

Transferencias

Movimientos

Obtén estados de cuenta

Listar estados de cuenta

Descargar el PDF

Probar la integración

​Listar estados de cuenta

​Descargar el PDF

​Probar la integración

Listar estados de cuenta

Descargar el PDF

Probar la integración