Conectar SPEI directo a tu ERP o plataforma es lo que separa una fintech que opera sola de una que depende de subir archivos a mano. Esta guia tecnica 2026 explica las opciones para integrar SPEI por API en CDMX, como recibir y enviar pagos automaticamente, y como cerrar el ciclo con conciliacion, sin perderte en la parte de infraestructura.
Respuesta corta: Para integrar SPEI por API tienes dos caminos: conectar directo con un banco que exponga API (BBVA, Banorte y otros ofrecen APIs corporativas) o usar un agregador/PSP que abstrae el rail SPEI y te da una sola API con CLABEs, webhooks de pagos recibidos y dispersion. Con eso, tu ERP recibe y envia SPEI en automatico, y una capa de conciliacion empareja cada movimiento con su factura o registro. La eleccion depende de tu volumen, licencias y necesidad de control.
1. Las dos rutas para integrar SPEI
Ruta A - Directo con el banco: algunos bancos exponen API corporativa para consultar saldos, recibir notificaciones y dispersar. Da control y puede ser mas barato en volumen alto, pero cada banco tiene su API, su onboarding tecnico y sus tiempos.
Ruta B - Agregador / PSP: un proveedor de pagos te da una sola API que abstrae SPEI: emision de CLABEs, webhooks de pagos entrantes, dispersion y a veces CoDi. Mas rapido de integrar y multibanco, a cambio de una comision por operacion.
2. Cual te conviene
| Criterio | Directo banco | Agregador / PSP |
|---|---|---|
| Time to market | lento | rapido |
| Costo por operacion | bajo en volumen | comision |
| Multibanco | 1 por integracion | 1 API varios |
| Control | alto | medio |
| Mantenimiento | tu lado | del proveedor |
Muchas fintech empiezan con un agregador para salir rapido y migran parte del volumen a integracion directa cuando escala.
3. Recibir pagos: CLABEs y webhooks
El patron moderno es asignar una CLABE por cliente o por transaccion. Cuando entra un SPEI a esa CLABE, el proveedor dispara un webhook a tu sistema con los datos del pago. Tu ERP lo recibe, identifica al cliente por la CLABE y actualiza el saldo o marca la factura como pagada, en segundos y sin intervencion.
Integra SPEI con tu ERP
Diagnostico gratuito de 30 minutos, 100% remoto. Te decimos que se automatiza primero y cuanto ahorra.
4. Enviar pagos: dispersion
Para pagar proveedores, nomina o devoluciones, la API de dispersion envia SPEI de forma programatica. Se hace con controles: doble confirmacion para montos altos, limites, y registro de cada orden. La IA puede validar la orden contra reglas antes de ejecutarla, pero el envio de dinero siempre requiere autorizacion humana.
5. Cerrar el ciclo con conciliacion
Integrar SPEI sin conciliar deja la mitad del trabajo. La capa de conciliacion cruza cada webhook de pago recibido y cada dispersion enviada contra tu contabilidad y tus CFDI, de modo que tu ERP siempre refleja la realidad del banco. Ese cierre automatico es el verdadero valor.
6. Buenas practicas tecnicas
- Idempotencia: maneja webhooks repetidos sin duplicar pagos.
- Reintentos y cola: si tu sistema esta caido, no pierdas notificaciones.
- Firmas y seguridad: valida la firma del webhook; usa credenciales seguras.
- Conciliacion de respaldo: cruza contra el estado de cuenta por si un webhook falla.
- Sandbox: prueba todo el flujo antes de produccion.
7. Cuanto cuesta la integracion
| Alcance | Setup (MXN) | Notas |
|---|---|---|
| Recepcion via agregador | 40.000-90.000 | + comision PSP |
| Recepcion + dispersion | 90.000-180.000 | controles |
| Integracion directa banco | 180.000+ | segun banco |
8. Como empezar
Se define la ruta segun tu volumen y licencias, se integra en sandbox el flujo de recepcion (que es el de mayor valor inmediato) y se agrega dispersion y conciliacion. Ve el servicio de integraciones y APIs para el detalle tecnico.
9. Manejar los casos raros del SPEI
La integracion 'feliz' es facil; el diablo esta en los casos raros. Un SPEI puede llegar sin la referencia esperada, con un monto ligeramente distinto por un error del cliente, duplicado por un reintento, o devuelto por una CLABE mal capturada. Un sistema robusto contempla todos esos escenarios: no duplica, no pierde, y deja en una cola clara lo que necesita revision humana.
Diseñar para esos bordes desde el inicio es lo que separa una integracion que funciona en la demo de una que aguanta produccion real con miles de operaciones. La conciliacion de respaldo contra el estado de cuenta es tu red de seguridad: si un webhook falla, el cruce diario lo atrapa.
10. Escalar la integracion con tu volumen
Lo que funciona con 100 SPEI al dia puede tronar con 100.000. Al crecer importan cosas que antes no: la latencia de los webhooks, los limites de la API del proveedor, el manejo de picos (una promocion, un dia de quincena) y la capacidad de reprocesar sin duplicar. Vale la pena pensar la arquitectura para el volumen al que aspiras, no solo para el de hoy.
Aqui es donde la decision entre agregador e integracion directa vuelve a pesar: el agregador absorbe parte de esa complejidad, la integracion directa te da control para optimizar costos a gran escala. Muchas fintech maduran hacia un esquema hibrido, y tener la conciliacion como capa independiente hace ese cambio mucho menos doloroso.
Sobre Uniamos. Somos una agencia internacional remota con base en Austin (EE.UU.) y Ciudad de Mexico. Implementamos integraciones, conciliacion, cobranza y analitica con IA para fintech, neobancos y empresas en Mexico, LATAM y Espana, 100%% remoto via Calendly y WhatsApp. Mira nuestro servicio de integraciones y APIs o vuelve al blog.
Preguntas frecuentes
Cuales son las opciones para integrar SPEI por API?
Dos: conectar directo con un banco que exponga API corporativa (BBVA, Banorte y otros) o usar un agregador/PSP que abstrae SPEI en una sola API con CLABEs, webhooks y dispersion. La eleccion depende de volumen, licencias y control.
Como recibo pagos SPEI automaticamente?
Asignando una CLABE por cliente o transaccion. Cuando entra un SPEI a esa CLABE, el proveedor dispara un webhook a tu sistema, que identifica al cliente y actualiza el saldo o marca la factura como pagada en segundos.
Puedo enviar pagos (dispersar) por API?
Si, con la API de dispersion, siempre bajo controles: doble confirmacion para montos altos, limites y registro. El envio de dinero requiere autorizacion humana; la IA puede validar la orden pero no debe ejecutarla sola.
Que ruta conviene, banco directo o agregador?
Muchas fintech empiezan con un agregador para salir rapido y multibanco, y migran volumen a integracion directa con el banco cuando escala y el costo por operacion pesa mas que el time to market.
Por que necesito conciliacion si ya integre SPEI?
Porque integrar sin conciliar deja la mitad del trabajo. La conciliacion cruza cada pago recibido y cada dispersion contra tu contabilidad y tus CFDI para que el ERP refleje la realidad del banco.
Que buenas practicas tecnicas debo cuidar?
Idempotencia para no duplicar pagos, reintentos y colas para no perder webhooks, validacion de firma y seguridad de credenciales, una conciliacion de respaldo contra el estado de cuenta y pruebas en sandbox antes de produccion.
Cuanto cuesta integrar SPEI?
La recepcion via agregador parte de ~40.000 MXN de setup mas la comision del PSP; sumar dispersion lo lleva a 90.000-180.000 MXN, y una integracion directa con banco desde 180.000 MXN segun el banco.