Extracción de estados de cuenta · México

Convierte estados de cuenta de Hey Banco a JSON

TL;DR

finO$ extrae transacciones, saldos, conceptos y categorías de estados de cuenta de Hey Banco en JSON estructurado. Pricing: $5 MXN por hoja. Un estado típico de 4 hojas cuesta $20 MXN. Soporta cuenta hey.

Hey Banco (Banregio) es la oferta digital de Banregio. Estados PDF cortos con layout limpio diseñado para usuarios móviles, generados al instante desde la app.

Ver documentación del API

Tipos de cuenta soportados

finO$ procesa los siguientes layouts de Hey Banco:

Cuenta Hey

Qué extrae finO$ de un estado de Hey Banco

El schema v5 aplica igual para los 1 tipos de cuenta de Hey Banco. Hey Banco (Banregio) es la oferta digital de Banregio. Estados PDF cortos con layout limpio diseñado para usuarios móviles, generados al instante desde la app. El JSON resultante tiene la misma estructura que para cualquier otro banco soportado.

Identidad del banco y cuenta

bank_name

Nombre raw como aparece en el PDF (con sufijos legales).

string
bank_canonical_name

Brand reconocible (BBVA, Rappi, Nu, DólarApp).

string
account_number

Número de cuenta, tarjeta enmascarada o CLABE.

string
account_type

debit · credit · null

enum

Saldos

Cada uno con amount + ISO 4217
opening_balance

Saldo inicial del periodo.

currency
closing_balance

Saldo al corte.

currency
average_balance

Saldo promedio (solo débito; null en CC).

currency

Resumen del periodo

total_commissions

Comisiones cobradas totales.

currency
statement_period_start

Inicio del periodo.

date
statement_period_end

Fin del periodo.

date

Titular

account_holder_name

Nombre del titular.

string
account_holder_rfc

RFC (12-13 caracteres).

string
account_holder_address

Dirección registrada.

string

transactions[]

14 campos por movimiento

Cada movimiento del periodo. Las líneas tipo "AMAZON A MESES 2/12" van al array de meses sin intereses, NO aquí — solo la compra original aparece como transaction.

day

Día del mes.

number 1-31
month

Mes; el año se deriva de statement_period_start.

number 1-12
description

Texto verbatim como sale en el PDF.

string
transaction_concept

Versión normalizada del concepto.

string
counterparty_name

Beneficiario o comercio del otro lado.

string
counterparty_rfc

RFC de la contraparte (común en SPEI).

string
merchant_canonical_name

Marca limpia: "Uber Eats", "Amazon", "OXXO" (null si no aplica).

string
amount

Magnitud SIEMPRE positiva.

post-v3 schema fix

number ≥ 0
currency

MXN, USD, EUR…

ISO 4217
transaction_type

DEBIT (inflow) · CHARGE (outflow).

enum
direction

inflow · outflow.

Señal redundante para detectar discrepancias.

enum
channel

SPEI · card · cash · check · direct_debit · internal_transfer · interest · fee · other.

enum
category

food · transport · shopping · bills · entertainment · healthcare · travel · fees · income · transfer · cash · savings_investment · taxes · other.

enum
kind_hint

expense · income · internal_transfer_likely · refund_likely · cashback_likely.

enum
is_recurring_likely

True para Netflix, CFE, nómina, MSI, suscripciones SaaS.

boolean

zero_interest_installments[]

8 campos por plan MSI

Planes de meses sin intereses activos. Cada uno se rastrea por separado para evitar inflar el flujo del periodo con cuotas.

description

"AMAZON A MESES", "AVIANCA", "BEST BUY".

string
purchase_date

Fecha de la compra original.

date
original_amount

Total de la compra antes de partirla.

currency
current_payment_number

Cuál de las cuotas se está pagando este corte.

number
total_payments_number

Cuotas totales del plan (3, 6, 12, 18, 24…).

number
monthly_installment

Mensualidad fija.

currency
interest_rate

% anual (0 para MSI puro).

number
pending_amount

Saldo aún por pagar en cuotas futuras.

currency

Ver el schema completo y ejemplo de response en /api/#data-structure

Ejemplo: Hey Banco en 30 segundos

1. PDF de entrada

Sube el PDF descargado de la banca en línea o app de Hey Banco.

2. Procesamiento

finO$ extrae transacciones, saldos, conceptos. ~15s típico.

3. JSON estructurado

Listo para tu API contable, ERP o motor de scoring.

Ejemplo · curl

curl -X POST https://api.getfinos.com/v1/upload \
  -H "Authorization: Bearer $FINOS_API_KEY" \
  -F "file=@hey-banco-mexico-statement.pdf" \
  -F "bank_hint=hey-banco_mx"

# {"job_id": "job_abc123", "status": "processing"}

curl https://api.getfinos.com/v1/extractions/job_abc123 \
  -H "Authorization: Bearer $FINOS_API_KEY"

# {
#   "bank": "Hey Banco",
#   "country": "MX",
#   "period": { "start": "2026-04-01", "end": "2026-04-30" },
#   "transactions": [ ... ]
# }

Otros bancos en México

finO$ soporta los principales bancos de México:

BBVA México Santander México Citibanamex Banorte HSBC México Scotiabank México Ver todos los bancos →

Preguntas sobre extracción de Hey Banco

¿Cuánto cuesta extraer un estado de cuenta de Hey Banco?

El API de finO$ cuesta $5 MXN por hoja procesada. Un estado típico de Hey Banco tiene alrededor de 4 hojas, lo que da un costo aproximado de $20 MXN por estado. Sin suscripción mínima.

¿finO$ soporta el formato actual de PDF de Hey Banco?

Sí. finO$ soporta los formatos vigentes (Cuenta Hey) incluyendo los layouts actualizados en 2025. Si encuentras un formato no soportado, lo agregamos en 48-72 horas con una muestra anonimizada.

¿Funciona con PDFs escaneados de Hey Banco?

Hey Banco típicamente exporta PDFs nativos desde su app/web, no requiere OCR. Si recibes un screenshot impreso de la app, finO$ aplica OCR automático.

¿Puedo categorizar las transacciones automáticamente?

Sí. finO$ aplica auto-categorización basada en patrones de comerciantes locales y NLP en español. La taxonomía es ajustable y compatible con el catálogo SAT (México), DIAN (Colombia), AFIP (Argentina), SII (Chile) y SUNAT (Perú) según corresponda.