Conecta cuentas Spin by OXXO, transferencias y datos de tarjeta Visa con tu stack — bajo las reglas fintech mexicanas
Spin by OXXO-Tu Cuenta Digital, operada por Compropago S.A. de C.V. IFPE bajo FEMSA, cerró 2024 con 13.1 millones de usuarios activos y procesó un promedio de 73.7 millones de transacciones mensuales en el segundo trimestre de 2025. Ese volumen se respalda en una billetera, una tarjeta Visa y más de 24,000 puntos de efectivo OXXO — un conjunto de datos especialmente rico para casos de uso de Open Finance en México. Entregamos análisis de protocolos, flujos de login estilo OAuth, endpoints de transferencias SPEI/CoDi, historial de transacciones Visa, eventos de entrada/salida de efectivo OXXO y exportaciones de lealtad Spin Premia como código fuente ejecutable en Python o Node.js, listo para integrarse en productos de conciliación, contabilidad o remesas.
Qué entregamos
Lista de entregables
- Especificación OpenAPI 3.1 para cada endpoint que entregamos
- Reporte de protocolo y flujo de autenticación (cadena de tokens, vinculación de dispositivo, firma)
- Código ejecutable de login, estado de cuenta y SPEI (Python, Node.js o Go)
- Receptores de webhooks para eventos de CoDi, SPEI y autorizaciones Visa
- Utilidades de exportación a Excel/CSV/PDF para entrega contable
- Colección Postman, pruebas de integración y datos semilla de sandbox
- Notas de cumplimiento: CNBV/Banxico, Ley Fintech, Llave MX, manejo de INE/CURP
Modelos de contratación
Dos formas de trabajar con nosotros, ambas diseñadas para reducir el riesgo inicial:
- Entrega de código fuente desde $300 USD — código API ejecutable más documentación, pagado solo a la aceptación.
- API hospedada con pago por llamada — invoca nuestros endpoints administrados de Spin by OXXO con un bearer token; paga solo lo que usas, sin cuota de instalación.
Ambos modelos pueden combinarse: prototipa en el endpoint hospedado y luego recibe la entrega del código fuente para operarlo internamente.
Datos disponibles para integración
A continuación está el inventario de datos que típicamente exponemos para Spin by OXXO. Cada renglón mapea un tipo de dato a la pantalla o función de origen dentro de la app, la granularidad de la exportación y un caso de uso típico aguas abajo. La lista se deriva de la descripción pública del producto Spin by OXXO, los reportes trimestrales de FEMSA y nuestros propios trazos de protocolo.
| Tipo de dato | Origen (pantalla / función) | Granularidad | Uso típico |
|---|---|---|---|
| Perfil de cuenta y estado KYC | Alta (teléfono + escaneo de INE) | Por usuario, con marcas de tiempo | Verificación de identidad, gating de cumplimiento |
| Saldo de la billetera | Pantalla principal "Saldo" | MXN en tiempo real | Tableros de tesorería, alertas de saldo bajo |
| Transferencias SPEI (entrada/salida) | Módulo de Transferencias | Por transacción, clave de rastreo | Conciliación, screening antifraude |
| Cobros con QR CoDi | Cobrar / pagar QR | Por QR, por liquidación | Reporteo POS, payouts a comercios |
| Autorizaciones de tarjeta Visa | Tarjeta digital / física | MCC, comercio, monto, FX | Análisis de gasto, gestión de viáticos |
| Depósitos / retiros en efectivo OXXO | Eventos en tienda OXXO | Por tienda, por ticket | Análisis de flujo de efectivo, señales PLD |
| Pago de servicios y recargas | Servicios / Recargas | Por proveedor, por recarga | Tracking de suscripciones, presupuesto del hogar |
| Puntos de lealtad Spin Premia | Motor de triple puntos | Por acumulación / canje | CRM de lealtad, atribución a marcas socias |
| Remesas transfronterizas | EE. UU. → MX entrantes (estilo Kira) | Por remesa, FX, ID de remitente | Finanzas para diáspora, reporteo de cumplimiento |
Escenarios típicos de integración
1. Conciliación contable para PyMEs
Una PyME mexicana que usa Spin by OXXO como su billetera operativa necesita datos diarios de SPEI y de tarjeta Visa dentro de Contpaqi, Aspel o QuickBooks. Entregamos un job nocturno que extrae SPEI entrante/saliente y autorizaciones Visa, los normaliza en un esquema común de mayor y empuja los renglones a través de la API de importación de la herramienta contable. Es un caso de uso de solo lectura típico de Open Finance bajo el próximo estándar técnico de la CNBV.
2. Onboarding de corredor de remesas
Un operador de remesas en EE. UU. quiere depositar fondos directo en billeteras Spin by OXXO, replicando la alianza Kira de 2025. Nuestra integración cubre búsqueda de beneficiario por teléfono o CLABE, registro de conversión FX, inicio de depósito SPEI y un webhook de regreso a la app del remitente con la clave de rastreo para generación del comprobante.
3. Embedded finance para minoristas
Una cadena minorista quiere pagar facturas de proveedores desde una subcuenta de negocio Spin by OXXO y conciliar los depósitos de efectivo en tiendas OXXO contra los totales esperados por ticket. Exponemos generación de QR CoDi para cobros, pagos SPEI para facturas de proveedores y un feed diario de entradas en efectivo que empata depósitos por tienda con IDs de factura.
4. Enriquecimiento de lealtad y CRM
Una marca de consumo que patrocina campañas de triple puntos Spin Premia quiere datos de atribución: qué transacciones Visa en qué comercios dispararon qué acumulaciones de puntos. La pipeline de exportación une eventos de autorización Visa con registros de acumulación Spin Premia y empuja la unión hacia Segment, mParticle o un data warehouse de cliente.
5. Monitoreo de PLD y riesgo
Un equipo de cumplimiento necesita visibilidad casi en tiempo real sobre depósitos y retiros de efectivo en más de 24,000 tiendas OXXO más velocidad SPEI por usuario. Nuestro fan-out de webhooks entrega eventos a un motor de reglas (Sardine, Unit21 o in-house) con campos estructurados para monto, tienda, dispositivo, geolocalización y nivel KYC — insumos útiles para reportes estilo SAT y CNBV.
Implementación técnica
Login estilo OAuth (pseudocódigo)
POST /api/v1/spin/auth/login
Content-Type: application/json
X-Device-Id: 5e9b...
{
"phone": "+52 55 1234 5678",
"password": "***",
"device_fingerprint": "android:14:pixel-7"
}
200 OK
{
"access_token": "eyJhbGciOi...",
"refresh_token": "rt_2f8c...",
"expires_in": 1800,
"kyc_tier": 2,
"curp_verified": true
}
Consulta de estado de cuenta (pseudocódigo)
POST /api/v1/spin/statement
Authorization: Bearer <ACCESS_TOKEN>
{
"account_id": "spin:5215512345678",
"from_date": "2026-04-01",
"to_date": "2026-04-30",
"types": ["SPEI_IN","SPEI_OUT","CARD","OXXO_CASH"],
"page": 1, "page_size": 100
}
200 OK
{
"items": [
{"id":"tx_01","type":"SPEI_IN","amount":1500.00,"currency":"MXN",
"clave_rastreo":"SPEI20260415...","counterparty_clabe":"012180...",
"ts":"2026-04-15T10:22:11-06:00"},
{"id":"tx_02","type":"CARD","amount":-249.50,"currency":"MXN",
"merchant":"OXXO 1234 CDMX","mcc":"5499",
"ts":"2026-04-15T18:45:02-06:00"}
],
"next_page": 2
}
Webhook de pago SPEI (pseudocódigo)
POST {your_webhook}
X-Spin-Signature: t=1714560000,v1=8a3f...
{
"event":"spei.payout.settled",
"payout_id":"po_9f2c",
"clave_rastreo":"SPEI20260501ABC123",
"amount":2500.00,"currency":"MXN",
"beneficiary_clabe":"012180001234567890",
"status":"SETTLED",
"settled_at":"2026-05-01T09:14:55-06:00"
}
# Verifica el HMAC, responde 200 y luego actualiza el mayor.
El manejo de errores sigue la semántica HTTP estándar con un pequeño envoltorio JSON de problem-details (code, message, request_id). Las claves de idempotencia son obligatorias en todas las mutaciones SPEI/CoDi. La renovación de tokens, rotación de vinculación de dispositivo y el back-off de rate-limit vienen cableados por defecto.
Cumplimiento y privacidad
Marco fintech mexicano
Spin by OXXO opera como una IFPE (Institución de Fondos de Pago Electrónico) autorizada por la Comisión Nacional Bancaria y de Valores (CNBV) bajo la Ley Fintech de 2018 y las reformas de la Ley Fintech 2.0 de 2025. En octubre de 2024, Spin recibió autorización de Banco de México para conectarse de forma directa al SPEI e implementar DiMo y CoDi. Nuestras integraciones permanecen dentro de ese perímetro: consentimiento explícito del usuario, espejado de KYC en lugar de bypass, y apego al próximo estándar técnico de Open Finance y a las guías de consentimiento de la CNBV/Banxico, además de alinearse con la nueva Llave MX como identidad digital nacional.
Privacidad y minimización de datos
Todas las entregas siguen la Ley Federal de Protección de Datos Personales en Posesión de los Particulares (LFPDPPP) de México. Solo se transmite la información requerida para el escenario acordado, los campos INE/CURP se tokenizan y los datos de tarjeta sujetos a PCI se referencian mediante token de red en lugar del PAN. Los rieles SPEI siguen la especificación pública de SPEI mantenida por el Banco de México.
Flujo de datos y arquitectura
Una integración típica con Spin by OXXO usa una pipeline de cuatro etapas:
- Cliente / móvil: la app Spin o un cliente de replay del lado del servidor se autentica con teléfono + contraseña + huella de dispositivo y guarda el refresh token en una bóveda.
- API de ingestión: nuestro gateway intermedia las llamadas a los endpoints de login, estado de cuenta, SPEI y CoDi, aplica claves de idempotencia y guardas de rate-limit.
- Almacenamiento: los eventos se persisten en PostgreSQL (transacciones) y S3 / GCS (payloads crudos, exportaciones), con cifrado a nivel renglón sobre los campos de información personal.
- Analítica / salida: los consumidores aguas abajo — herramientas contables, tableros de BI, motores de riesgo o APIs de socios — leen los datos normalizados vía REST/GraphQL o exportaciones programadas a Excel/CSV.
Posicionamiento de mercado y perfil de usuario
Spin by OXXO se dirige a consumidores mexicanos no bancarizados y subbancarizados — una base B2C que se inclina entre los 18 y los 45 años, mobile-first en Android e iOS, que transacciona con frecuencia en efectivo a través de tiendas OXXO mientras usa la billetera digital para SPEI, comercio electrónico y pago de servicios. Los usuarios activos crecieron de 9.8M en Q4 2023 a 13.1M en Q4 2024, y FEMSA ha explorado públicamente obtener una licencia bancaria para profundizar el producto. La audiencia de integración para nuestras APIs es mayoritariamente B2B: PyMEs mexicanas, operadores de remesas EE. UU.–México, minoristas regionales, plataformas contables y agregadores fintech que quieren leer o escribir datos de Spin by OXXO en nombre de usuarios autorizados.
Capturas de pantalla
Toca cualquier miniatura para ampliarla.
Apps similares y panorama de integración
Los equipos que integran Spin by OXXO con frecuencia necesitan armonizar datos con otras billeteras y neobancos mexicanos. A continuación está el ecosistema más amplio con el que trabajamos habitualmente; listamos cada app de forma neutral como parte del panorama de Open Finance y no como un ranking.
- Mercado Pago — La billetera de Mercado Libre concentra órdenes de e-commerce, pagos QR y saldos de mercado de dinero; quienes también operan con Mercado Pago suelen necesitar exportaciones unificadas de transacciones entre ambas plataformas.
- Cuenca — IFPE mexicana que ofrece cuentas SPEI y una Mastercard; los patrones de integración reflejan los de Spin by OXXO y suelen combinarse para vistas de saldo entre billeteras.
- Fondeadora — Cuentas de débito personales y de negocio con interés sobre el saldo; los equipos financieros frecuentemente consolidan transacciones de Fondeadora y Spin en el mismo feed contable.
- Nu Mexico (Nubank) — Neobanco brasileño que opera tarjetas de crédito y ahorro en México y crece rápido entre usuarios jóvenes; relevante para análisis de gasto cruzado entre productos.
- Klar — Emisor digital de crédito y débito en México; la lógica de exportación de estado de cuenta es similar a los flujos Visa de Spin.
- RappiPay — Billetera adjunta a la superapp de delivery Rappi; los casos de uso de integración traslapan con escenarios de retail y remesas.
- Stori — Neobanco enfocado en tarjeta de crédito para segmentos subbancarizados; las vistas combinadas con Spin ayudan a los suscriptores de crédito a ver tanto patrones de gasto como de entrada de efectivo.
- Albo — Neobanco mexicano con cuentas personales y de negocio; suele acompañar a Spin by OXXO en setups de tesorería para PyMEs.
- BBVA Wallet (Mexico) — Tarjeta tokenizada y funciones SPEI dentro del banco más grande de México; las transacciones Spin se concilian comúnmente contra cuentas primarias de BBVA.
- Banco Azteca — Banco minorista con muchas sucursales y una app móvil que atiende segmentos demográficos similares a los de Spin by OXXO; útil para hacer benchmarking de flujos de remesas y entradas de efectivo.
Acerca de nosotros
OpenFinance Lab es un estudio técnico independiente enfocado en análisis de protocolos fintech móviles e integración de APIs autorizadas. Nuestros ingenieros provienen de IFPEs mexicanas, gateways de pago, ingeniería inversa móvil e infraestructura cloud, y hemos entregado integraciones de billetera, tarjeta y SPEI para clientes en LATAM, EE. UU. y Europa.
- Integraciones de billetera, neobanco, remesas y POS en LATAM
- Gateways SPEI/CoDi, flujos de consentimiento de solo lectura para Open Finance
- SDKs personalizados en Python, Node.js y Go con suites de pruebas completas
- Pipeline integral: análisis de protocolo → build → validación → revisión de cumplimiento
- Entrega de código fuente desde $300 USD, pagada solo a la aceptación
- API hospedada con pago por llamada para equipos que prefieren tarificación por uso
Contacto
Para cotizaciones o para enviarnos tu app objetivo y los requerimientos, abre nuestra página de contacto:
Indícanos la app objetivo (por ejemplo Spin by OXXO), el alcance de datos (SPEI, Visa, CoDi, Premia) y si prefieres entrega de código fuente o la API hospedada con pago por llamada.
Flujo de trabajo de contratación
- Confirmación de alcance — qué datos de Spin by OXXO y qué acciones de escritura (SPEI, CoDi, Premia) entran al alcance.
- Análisis de protocolo y diseño de la API (2–5 días hábiles, dependiendo de la complejidad).
- Build y validación interna contra cuentas de sandbox o cuentas espejo (3–8 días hábiles).
- Documentación, ejemplos y casos de prueba (1–2 días hábiles).
- Primera entrega típica: 5–15 días hábiles; los flujos de consentimiento alineados con CNBV/Banxico pueden alargar los tiempos.
Preguntas frecuentes
¿Qué datos de Spin by OXXO se pueden integrar mediante sus APIs?
¿Cuánto tarda en entregarse una integración con Spin by OXXO?
¿Cómo manejan el cumplimiento fintech mexicano?
¿Soportan remesas transfronterizas a cuentas Spin by OXXO?
📱 Resumen de la app original (anexo)
Spin by OXXO-Tu Cuenta Digital es una cuenta digital mexicana gratuita de la unidad Spin de FEMSA, operada por Compropago S.A. de C.V. IFPE. Los usuarios abren una cuenta en minutos al ingresar un número de teléfono y un correo y escanear su INE; la cuenta incluye una tarjeta Visa virtual y una tarjeta física opcional disponible en cualquier tienda OXXO.
Una vez activa, los usuarios pueden:
- Enviar y recibir transferencias SPEI en segundos con cualquier banco mexicano.
- Depositar y retirar efectivo en más de 23,000 tiendas OXXO.
- Pagar en persona y en línea con la tarjeta Visa (digital o física).
- Recargar tiempo aire para sí mismos o para sus amigos.
- Pagar servicios (luz, agua, internet, teléfono) directamente desde la app.
- Pagar con código QR vía CoDi desde la cuenta digital.
- Ganar el triple de puntos Spin Premia en tiendas OXXO y marcas socias y canjearlos por productos o tiempo aire.
- Recibir depósitos desde el extranjero directos a la cuenta Spin.
Para el Q4 de 2024, Spin by OXXO había alcanzado 13.1 millones de usuarios activos; para el Q2 de 2025 procesaba aproximadamente 73.7 millones de transacciones por mes, y FEMSA había extendido por otros ocho años su alianza con Visa al tiempo que exploraba una licencia bancaria mexicana completa.