Bank statement extraction · Peru

Convert BanBif bank statements to JSON

TL;DR

finO$ extracts transactions, balances, concepts, and categories from BanBif bank statements into structured JSON. Pricing: $5 MXN per page (~$0.28 USD). A typical 7-page statement costs $35 MXN (~$1.94 USD). Supports cuenta de ahorros, cuenta corriente, empresarial.

See API documentation

Supported account types

Cuenta de ahorrosCuenta corrienteEmpresarial

What finO$ extracts from a BanBif statement

The v5 schema applies the same way to all 3 account types of BanBif. The output JSON has the same structure regardless of which bank you upload.

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

See the full schema and response example at /api/#data-structure

Example: BanBif in 30 seconds

1. PDF input

Upload the PDF downloaded from BanBif online banking or app.

2. Processing

finO$ extracts transactions, balances, concepts. ~15s typical.

3. Structured JSON

Ready for your accounting API, ERP, or scoring engine.

Example · curl

curl -X POST https://api.getfinos.com/v1/upload \
  -H "Authorization: Bearer $FINOS_API_KEY" \
  -F "file=@banbif-peru-statement.pdf" \
  -F "bank_hint=banbif_pe"

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

Other banks in Peru

BCP (Banco de Crédito del Perú) BBVA Perú Interbank Scotiabank Perú Banco Pichincha Perú Yape (BCP) See all banks →

BanBif extraction FAQ

How much does it cost to extract a BanBif statement?

The finO$ API costs $5 MXN per processed page (~$0.28 USD). A typical BanBif statement has around 7 pages, totaling about $35 MXN per statement. No minimum subscription.

Does finO$ support the current BanBif PDF format?

Yes. finO$ supports current formats (Cuenta de ahorros, Cuenta corriente, Empresarial) including layouts updated in 2025. If you find an unsupported format, we add support within 48–72 hours from an anonymized sample.

Does it work with scanned BanBif PDFs?

Yes. BanBif typically delivers native digital PDFs, but finO$ applies automatic OCR when it detects a scanned PDF. Accuracy on good-quality scans is >97%.

Can I auto-categorize transactions?

Yes. finO$ applies auto-categorization based on local merchant patterns and Spanish NLP. Taxonomy is adjustable and compatible with SAT (Mexico), DIAN (Colombia), AFIP (Argentina), SII (Chile), and SUNAT (Peru) chart-of-accounts mapping.