Conecta cuentas, transacciones y controles de tarjeta de App Banamex con tu stack
App Banamex (paquete com.citibanamex.banamexmobile) es el principal canal móvil de uno de los cuatro mayores bancos minoristas de México. Convertimos el valor que reside dentro de la app — saldos de cuentas de cheques y de tarjeta de crédito, transferencias SPEI entrantes y salientes, cobros por QR de CoDi, archivos de estados de cuenta, paquetes de ahorro y posiciones de inversión — en endpoints JSON estables que tu sistema de contabilidad, tesorería o riesgo puede consumir sin tocar la pantalla.
Datos disponibles para integración
La tabla siguiente resume los activos de datos observados en App Banamex y cómo cada uno se mapea a un consumidor típico de Open Finance / OpenData. La granularidad refleja lo que la pantalla in-app expone; entregamos los mismos campos del lado servidor.
| Tipo de dato | Pantalla / función fuente | Granularidad | Uso típico |
|---|---|---|---|
| Saldo de cuenta y tarjeta | Inicio / "Mis cuentas" | Por cuenta, en tiempo real, MXN/USD | Conciliación de tesorería, tableros de flujo de efectivo |
| Historial de transferencias SPEI | Movimientos / Transferencias | Por transacción con CLABE, concepto, referencia, comisiones | Contabilidad, asiento en ERP, monitoreo PLD |
| Cobros CoDi | CoDi cobros | Por solicitud y evento de liquidación de QR / número telefónico | Conciliación de comerciantes, comercio in-app |
| Movimientos de tarjeta | Tarjetas de crédito / débito | Autorización, liquidación, MCC, contraparte | Analítica de gasto, automatización de gastos |
| Estados de cuenta | Descarga "Estados de cuenta" | PDF mensual + partidas extraídas | Pista de auditoría, solicitudes de hipoteca / préstamo |
| Paquetes de ahorro | Paquetes de Ahorro | Meta, calendario, saldo actual, fin proyectado | Widgets PFM basados en metas |
| Posiciones de inversión | Inversiones | Código de fondo, unidades, NAV, valuación | Tableros patrimoniales, sincronización de robo-advisor |
| Estado de control de tarjeta | Bloquear / Desbloquear, CVV dinámico | Bandera por tarjeta + CVV dinámico | Antifraude, checkout en línea seguro |
Escenarios típicos de integración
1. Auto-conciliación SPEI para facturación SaaS
Los compradores B2B mexicanos liquidan facturas por SPEI más que con tarjetas. Nuestro servicio sondea el feed SPEI entrante de Banamex del cliente cada 60 segundos, parsea los campos concepto y referencia numerica y los empareja con los IDs de factura en tu sistema de cobro. De extremo a extremo esto convierte un trabajo manual de back-office en un webhook tipo Stripe con eventos de "factura pagada".
Se mapea a: "servicio de información de cuentas" (AIS) de Open Finance + extracción personalizada de eventos de pago.
2. Agregación PFM multi-banco
Las apps de finanzas personales y presupuestos en México necesitan un único flujo de transacciones a través de BBVA México, Banorte, Santander y Banamex. Exponemos un endpoint normalizado /transactions sobre Banamex con el mismo esquema que entregamos para los otros tres, de modo que la app consumidora se integra una vez y atiende a los cuatro emisores.
Se mapea a: AIS de Open Finance — información de cuentas a través de múltiples ASPSPs.
3. Scoring crediticio alternativo
Para préstamos a clientes con historial crediticio limitado en México, el flujo de efectivo a nivel transacción supera una foto del buró de hace 6 meses. Entregamos 12 meses de partidas derivadas del estado de cuenta — ingresos por nómina, gastos fijos, MCCs de juegos de azar — aptas para ingestión por una pipeline de scoring en Python. El flujo es totalmente impulsado por consentimiento y registrado con timestamp para auditoría tipo SOC2.
Se mapea a: suscripción crediticia por flujo de efectivo (categoría CNBV "datos transaccionales agregados").
4. Gestión de gastos y conciliación de tickets
Las tarjetas corporativas emitidas a través de Banamex alimentan un webhook de movimientos de tarjeta en tiempo real hacia herramientas de gastos (Rindegastos, Mendel, Clara). El webhook lleva MCC, nombre del comercio e importe, los cuales emparejamos con tickets digitalizados por OCR en el cliente. El bloqueo/desbloqueo de tarjeta se expone vía la misma puerta de enlace para que finanzas pueda detener una tarjeta extraviada sin abrir la app.
Se mapea a: API de eventos del emisor de tarjetas + controles del instrumento de pago.
5. Sincronización de tablero de inversiones
Los hogares dividen tenencias entre Banamex Inversiones, GBM+, Kuspit y apps de corretaje. Extraemos las posiciones de fondos de Banamex en una foto diaria, normalizamos a ISIN cuando es posible, y emitimos un CSV que el rastreador de portafolio del usuario importa a la mañana siguiente. Sin scraping de pantalla en horas de mercado, sin presión adicional de sesión sobre el banco.
Se mapea a: servicio de agregación patrimonial / OpenInvestment.
Implementación técnica
Auth y bootstrap de sesión
POST /api/v1/banamex/session
Content-Type: application/json
X-Client-Id: of_lab_partner_xxx
{
"client_number": "12345678",
"password": "<encrypted>",
"totp": "453219",
"device_id": "of-lab-svc-1"
}
200 OK
{
"access_token": "eyJhbGciOi...",
"refresh_token": "rft_...",
"expires_in": 1800,
"scopes": ["accounts:read","statements:read","cards:control"]
}
Exportación SPEI / movimientos
GET /api/v1/banamex/transactions
?account=646180110400000007
&from=2026-04-01&to=2026-04-30
&type=SPEI&cursor=eyJwYWdlIjoyfQ==
Authorization: Bearer <ACCESS_TOKEN>
{
"items": [{
"id": "MX26-04-29-7841",
"ts": "2026-04-29T10:14:33-06:00",
"amount": -25400.00, "currency": "MXN",
"counterparty_clabe": "012180001234567890",
"counterparty_name": "PROVEEDOR S DE RL",
"concept": "FACT 2026-04-127",
"reference": "20260427",
"fee": 0.00, "rail": "SPEI"
}],
"next_cursor": "eyJwYWdlIjozfQ=="
}
Webhook de bloqueo de tarjeta (servidor a servidor)
POST /webhooks/banamex/card-events
X-Signature: t=1714400000,v1=9b3a...
{
"event_id": "evt_01HXY...",
"type": "card.transaction.declined",
"card_last4": "4421",
"amount": 1899.00, "currency": "MXN",
"merchant": "STARBUCKS POLANCO",
"mcc": "5814",
"decline_reason": "card_frozen"
}
# Responde 200 en menos de 5s o reintentaremos hasta 6h
Todos los endpoints usan TLS 1.2+ y tokens bearer OAuth 2.0, igualando el perfil de seguridad publicado por el Banamex Developer Hub. Las solicitudes son idempotentes mediante X-Idempotency-Key y cuentan con límite de tasa por socio.
Cumplimiento y privacidad
Las integraciones de banca minorista mexicana operan bajo la Ley para Regular las Instituciones de Tecnología Financiera (Ley Fintech, 2018). El artículo 76 obliga a APIs de Open Finance entre bancos, sociedades de información crediticia y cámaras de compensación; la CNBV es la autoridad supervisora y Banco de México define las especificaciones técnicas. A día de hoy entregamos solo contra el nivel Open Data (productos, sucursales, cajeros) más acceso autorizado a cuenta consentido por el cliente — sin scraping de datos no consentidos.
Para protección de datos seguimos la LFPDPPP (la ley federal mexicana de datos personales) y aplicamos minimización de datos: solo los campos que el cliente marcó en la pantalla de consentimiento abandonan los servidores de Banamex en nuestra pipeline.
Flujo de datos / arquitectura
Un despliegue típico se ve así:
- App cliente — el usuario otorga consentimiento en tu UI.
- Gateway de OpenFinance Lab — puente OAuth, bóveda de tokens, firmado de solicitudes.
- Backend de Banamex — APIs OpenData del Developer Hub + endpoints autorizados por el cliente.
- Normalizador — convierte importes en MXN, MCCs y CLABEs a tu esquema canónico.
- Almacenamiento / Analítica — Postgres / BigQuery para transacciones; Redis para saldos de corta vida.
- Salida — webhook, REST o CSV en lote hacia tu consumidor downstream (ERP, BI, scoring).
Capturas de App Banamex
Haz clic en cualquier miniatura para verla a tamaño completo. Estas pantallas de referencia guían nuestro mapa de campos obtenido por ingeniería inversa.
Posicionamiento de mercado y perfil de usuario
App Banamex es la puerta de entrada móvil para aproximadamente 20 millones de clientes minoristas concentrados en México, con un uso menor entre la diáspora en Estados Unidos y España. La base de clientes se inclina hacia titulares de nómina urbanos de ingresos medios y usuarios de tarjeta de crédito (Banamex es uno de los tres principales emisores de tarjetas de crédito de México), con un segmento PyME en crecimiento que usa SPEI para liquidación B2B. Tanto los clientes Android como iOS son de primera clase; el paquete de Play Store com.citibanamex.banamexmobile atiende a la mayoría de los activos mensuales. Por lo tanto las integraciones deben privilegiar cuentas denominadas en MXN, los rieles SPEI/CoDi y el KYC de residentes mexicanos.
Qué entregamos
Lista de entregables
- Especificación OpenAPI 3.1 para cada endpoint.
- Reporte de protocolo y flujo de auth (cadena OAuth, notas de TLS pinning, manejo de MFA / TOTP).
- Código fuente ejecutable para login, estado de cuenta y exportación SPEI — Python 3.11 y Node.js 20.
- Colección Postman / Insomnia más recetas curl para operaciones.
- Suite de pruebas unitarias e integración con fixtures anonimizadas.
- Resumen de cumplimiento: mapeo a Ley Fintech, minimización de datos LFPDPPP, guía de retención.
Ecosistema fintech similar y notas multi-banco
La mayoría de nuestros proyectos de Banamex coexisten con al menos otro emisor mexicano. Mantenemos los esquemas portables para que un cliente que hoy corra Banamex pueda añadir BBVA o Banorte mañana sin reescritura.
Apps similares y panorama de integración
Los equipos que integran App Banamex normalmente necesitan cobertura paralela de una o más de las siguientes apps mexicanas. Cada una almacena datos comparables pero ligeramente distintos; esta página es parte de un catálogo más amplio del ecosistema de banca minorista mexicano.
Sobre OpenFinance Lab
Somos un estudio independiente enfocado en análisis de protocolo de apps financieras, integración OpenData/Open Finance y entrega autorizada de APIs. Nuestros ingenieros vienen de bancos minoristas, procesadores de pago y trayectorias de ingeniería inversa de apps móviles. Para México específicamente damos seguimiento a la elaboración de reglas de Open Finance de la CNBV, al Banamex Developer Hub y a las especificaciones SPEI/CoDi de Banco de México, y entregamos APIs de extremo a extremo que cumplen con la envoltura legal arriba mencionada.
- Proyectos de banca, pagos, insurtech, remesas transfronterizas.
- SDKs personalizados en Python / Node.js / Go y arneses de pruebas.
- Pipeline completo: análisis de protocolo → build → validación → brief de cumplimiento.
- Entrega de código fuente desde 300 USD — código ejecutable + docs, pago tras la entrega.
- Cobro de API por llamada — accede a nuestro gateway alojado, sin costo inicial.
Contacto
Envíanos la app objetivo y un párrafo con el requerimiento. Responderemos en un día hábil con una nota de viabilidad y cotización.
Horario operativo solapado con horarios de negocio de EE. UU. / LATAM. Soporte en español e inglés.
Flujo de trabajo del proyecto
- Confirmación de alcance — qué pantallas / datos de Banamex realmente necesitas.
- Análisis de protocolo y diseño de API (2–5 días hábiles, según complejidad).
- Build y validación interna contra datos de fixture (3–8 días hábiles).
- Documentación, clientes de muestra y casos de prueba (1–2 días hábiles).
- Entrega — tú te quedas con el código, nosotros con el contrato de soporte.
- Primera entrega típica: 5–15 días hábiles; las aprobaciones de terceros pueden extender los plazos.
FAQ
¿Banamex tiene una API oficial de Open Banking?
¿Qué datos puedo extraer de App Banamex a través de sus servicios?
¿Cuánto tarda la entrega y cuánto cuesta?
¿La integración cumple con la legislación mexicana?
📱 Resumen de la app original (App Banamex / Citibanamex Móvil)
App Banamex es el cliente de banca móvil oficial del Banco Nacional de México (Banamex), históricamente el brazo minorista mexicano de Citi. Tras la separación institucional de Citigroup en 2024 y la venta a finales de 2025 de un 25% de participación a Fernando Chico Pardo, App Banamex ahora actúa como la interfaz de cliente del Grupo Financiero Banamex independiente antes de su OPI planeada. La app atiende a aproximadamente 20 millones de clientes minoristas en México.
Eslogan de marketing: “Lo que más usas, siempre a la mano.”
- Transferir dinero sin comisiones (SPEI, internas Banamex, CoDi).
- Comprar en línea con tarjetas digitales (CVV dinámico).
- Bloquear y desbloquear tarjetas a demanda.
- Recargar tiempo aire para los principales operadores mexicanos.
- Descargar estados de cuenta (PDF).
- Preventas exclusivas para tarjetahabientes Banamex.
- Inversiones — suscribir y rescatar fondos Banamex.
- Pólizas de seguros — auto, hogar, vida.
- "Paquetes de Ahorro" basados en metas.
- Bloquear llamadas fraudulentas.
Referencia: Listado de Google Play.