apiCEP
    ES|EN
    Volver al blog

    Cómo rastrear y validar un pago SPEI con API paso a paso

    Cómo rastrear un pago SPEI

    Para rastrear un pago SPEI necesitas consultar el Comprobante Electrónico de Pago (CEP) de Banxico con la fecha de operación, la clave de rastreo o número de referencia, el banco emisor, el banco receptor y el monto de la transferencia. Banxico explica que esos datos permiten identificar la operación y conocer su estado real dentro del sistema SPEI.

    Ese es el método oficial. Pero si tu empresa recibe muchos comprobantes, consultar cada pago manualmente en Banxico se vuelve lento. Por eso cada vez más negocios combinan el rastreo tradicional con validación automática por API.

    Qué es rastrear un pago SPEI realmente

    Mucha gente piensa que rastrear un SPEI es solo abrir el comprobante de la app del banco. En realidad, rastrear significa confirmar el estado oficial de la operación dentro del sistema SPEI de Banxico.

    Ese rastreo sirve para responder preguntas como:

    • ¿La transferencia sí fue liquidada?
    • ¿Fue rechazada?
    • ¿Está en proceso de devolución?
    • ¿Fue devuelta al ordenante?
    • ¿Los datos del comprobante coinciden con el CEP oficial?

    Banxico señala que el CEP es el documento que da certeza sobre la transferencia y contiene sello digital, cadena original y datos de la operación.

    Datos que necesitas para rastrear una transferencia SPEI

    Para hacer el rastreo correctamente debes tener a la mano:

    • Fecha en que se realizó el pago.
    • Clave de rastreo o número de referencia.
    • Banco emisor.
    • Banco receptor.
    • Cuenta destino: CLABE, tarjeta o número celular, según corresponda.
    • Monto exacto.

    Banxico define la clave de rastreo como un identificador de hasta 30 posiciones alfanuméricas proporcionado por la institución financiera, y el número de referencia como un identificador que el usuario selecciona al ordenar el pago.

    Paso a paso: cómo rastrear un pago SPEI en Banxico

    1. Entra al portal de CEP de Banxico.
    2. Selecciona la fecha de operación del pago.
    3. Captura la clave de rastreo o el número de referencia.
    4. Elige el banco emisor.
    5. Elige el banco receptor.
    6. Escribe la cuenta destino o el dato solicitado.
    7. Captura el monto exacto.
    8. Descarga el CEP en PDF o XML.

    Si el pago fue procesado por el SPEI y abonado en la cuenta receptora, Banxico indica que la consulta arrojará el CEP. Si no aparece el CEP, puede tratarse de un pago no procesado, con datos incorrectos o devuelto.

    Qué estados puedes encontrar al rastrear un SPEI

    Al consultar el estado de un pago, normalmente buscas saber si el dinero sí llegó o no. En la práctica, los estados más importantes son:

    | Estado | Qué significa para el negocio | |---|---| | Liquidado | El pago fue procesado y el dinero sí llegó | | En proceso | La instrucción sigue en curso | | Rechazado | El pago no fue aceptado por el sistema | | En proceso de devolución | El pago está regresando al ordenante | | Devuelto | El dinero ya regresó a la cuenta origen |
    Esta diferencia es fundamental porque un comprobante visual puede existir aunque el pago termine devuelto. Por eso rastrear no es opcional cuando el pago activa un pedido, una licencia, una suscripción o una renta.

    Problema real: rastrear manualmente no escala

    Si recibes 3 comprobantes al día, entrar a Banxico y consultar uno por uno puede ser manejable. Pero si tu operación recibe 50, 200 o 1,000 transferencias, el rastreo manual se vuelve un cuello de botella.

    Además, el proceso manual tiene otros problemas:

    • Depende de que un operador capture bien los datos.
    • Consume tiempo de soporte o finanzas.
    • No se integra automáticamente con tu CRM, ERP o eCommerce.
    • Puede retrasar la activación de pedidos o servicios.
    • Aumenta el riesgo de aceptar pagos con comprobantes falsos o devueltos.

    Ahí es donde una API de validación cambia completamente el flujo.

    Cómo rastrear y validar un pago SPEI con API

    Con apiCEP, el rastreo no depende de que una persona abra Banxico manualmente. Tu sistema envía la imagen del comprobante, apiCEP extrae los datos con OCR y consulta el CEP oficial para confirmar si la transferencia está liquidada.

    Ese proceso combina dos cosas en una sola llamada:

    1. Rastreo del pago — identifica la operación con los datos del comprobante.
    2. Validación oficial — consulta Banxico y devuelve el estado real del CEP.

    La respuesta incluye datos como validationId, trackingKey, referenceNumber, paymentConcept, banxicoConfirmed y cepStatus, que es el campo clave para saber si el pago quedó LIQUIDADA, DEVUELTO o en otro estado oficial.

    Ejemplo de respuesta para rastrear un SPEI con apiCEP

    json { "validationId": "b2c3d4e5-f6a7-8901-bcde-f12345678901", "status": "valid", "confidence": 0.97, "extracted": { "amount": 399.00, "trackingKey": "2026BBVA0000334455", "referenceNumber": "2457811", "paymentConcept": "Pago colegiatura mayo" }, "validation": { "banxicoConfirmed": true, "cepStatus": "LIQUIDADA" }, "downloads": { "cepPdf": "https://storage.apicep.cloud/.../cep.pdf", "cepXml": "https://storage.apicep.cloud/.../cep.xml" } }
    Si el cepStatus es LIQUIDADA, tu sistema puede confirmar el pago automáticamente. Si es DEVUELTO o EN_PROCESO_DE_DEVOLUCION, puedes detener la entrega o pedir un nuevo método de pago.

    Ejemplo de integración API para rastrear pagos SPEI

    javascript async function rastrearPagoSPEI(imageUrl) { const result = await fetch('https://api.apicep.cloud/validate-transfer', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.APICEP_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ imageUrl, beneficiary: { clabe: process.env.TU_CLABE, bank: process.env.TU_BANCO, name: process.env.TU_NOMBRE } }) }).then(r => r.json()); const estado = result.validation?.cepStatus; if (estado === 'LIQUIDADA') { await confirmarPago(result.validationId, result.downloads); } else if (estado === 'DEVUELTO') { await marcarComoDevuelto(result.validationId); } else if (estado === 'EN_PROCESO_DE_DEVOLUCION') { await programarRevision(result.validationId, 300); } return result; }
    Este flujo sirve para eCommerce, SaaS, colegiaturas, rentas, marketplaces, despachos y cualquier operación donde el estado real del SPEI determina si se activa un servicio.

    Clave de rastreo vs número de referencia

    Ambos datos ayudan a identificar una operación, pero no son lo mismo:

    | Dato | Quién lo define | Uso principal | |---|---|---| | Clave de rastreo | El banco o institución financiera | Identificar la transferencia en el sistema SPEI | | Número de referencia | El usuario al hacer el pago | Identificar internamente el motivo del pago |
    Para rastrear un pago, cualquiera de los dos puede ser útil, pero la clave de rastreo suele ser el dato más directo para localizar la operación.

    Diferencia entre rastrear manualmente y validar con API

    | Método | Ventaja | Limitación | |---|---|---| | Portal CEP de Banxico | Consulta oficial gratuita | Manual, uno por uno | | Revisión visual del comprobante | Rápida a simple vista | No confirma el estado real | | apiCEP | Rastreo + validación automática + CEP descargable | Requiere integración API |
    La diferencia importante es que el portal de Banxico sirve para consultas individuales, mientras que una API convierte el rastreo en un proceso operativo dentro de tu sistema.

    Casos donde sí conviene rastrear cada SPEI

    Rastrear y validar una transferencia es especialmente importante cuando el pago dispara una acción automática:

    • Confirmar un pedido de eCommerce.
    • Activar una licencia de software.
    • Registrar una colegiatura.
    • Confirmar una renta.
    • Liberar una reserva o inscripción.
    • Acreditar un pago a un expediente legal o contable.

    En todos esos casos, no basta con que el cliente mande un PDF o captura. Lo que importa es el estado oficial del CEP.

    Preguntas frecuentes sobre cómo rastrear un pago SPEI

    ¿Dónde se rastrea un pago SPEI?

    En el portal de CEP de Banxico, usando la fecha, la clave de rastreo o referencia, los bancos involucrados y el monto.

    ¿Qué pasa si no encuentro el CEP?

    Puede significar que el pago no fue procesado correctamente, que los datos capturados no coinciden o que la operación no quedó liquidada.

    ¿Puedo rastrear un SPEI con pura captura de pantalla?

    No de forma oficial. La captura ayuda a extraer datos, pero la validación real depende del CEP de Banxico.

    ¿Se puede automatizar el rastreo?

    Sí. Con una API como apiCEP puedes automatizar la extracción de datos, la consulta del estado y la descarga del CEP XML y PDF.

    Empieza a rastrear y validar SPEI automáticamente

    Si tu operación depende de comprobar transferencias, rastrear manualmente cada pago no escala. apiCEP te permite convertir el rastreo SPEI en un flujo automático: recibe el comprobante, extrae la clave de rastreo, consulta Banxico, devuelve el estado oficial y guarda el CEP en XML y PDF.

    Crea tu cuenta en apicep.cloud y prueba gratis las primeras 50 validaciones.