Cómo confirmar pagos SPEI automáticamente en tu plataforma de venta de boletos
Vendes boletos por internet — ¿pero quién verifica los comprobantes?
Construiste tu plataforma de venta de boletos. Tienes tu micrositio, tu cartelera, tu mapa de asientos. El proceso de compra es fluido. Y cuando alguien elige pagar por transferencia bancaria, tu sistema le indica la CLABE y espera.
Ahí empieza el problema.
El comprador hace el depósito, manda la captura del comprobante por WhatsApp o correo, y alguien en tu equipo tiene que revisar que el pago llegó antes de emitir el boleto. Si hay 5 compras simultáneas en el último día de preventa, ese proceso manual se convierte en un cuello de botella que puede hacerte perder ventas o, peor, entregar boletos sin haber recibido el pago real.
apiCEP elimina ese cuello de botella.
El riesgo real: comprobantes editados en venta de boletos
La industria de eventos tiene un problema específico que no existe en muchos otros sectores: la urgencia de compra justo antes del sold out.
Cuando un evento está al 87% de capacidad y el comprador sabe que los lugares se están acabando, el incentivo para enviar un comprobante falso o editado es mayor que en una compra normal. La presión de "confirma antes de que se acaben" hace que los equipos de taquilla cometan errores de revisión.
Un comprobante editado en una app de fotos se ve idéntico al original en pantalla. Solo la consulta directa a Banxico puede confirmar si la transferencia realmente ocurrió.
Cómo funciona apiCEP en una plataforma de boletos
apiCEP recibe la imagen del comprobante, extrae los datos con OCR y los verifica contra el registro oficial de Banxico. En menos de 10 segundos tu sistema sabe si el pago es real.
El flujo integrado en una plataforma de venta de boletos:
- El comprador elige sus lugares y selecciona "pagar por transferencia SPEI".
- El sistema muestra tu CLABE y reserva los asientos temporalmente.
- El comprador hace la transferencia y sube el comprobante en la misma plataforma.
- Tu sistema llama a apiCEP con la imagen del comprobante.
- apiCEP valida contra Banxico y devuelve el resultado en segundos.
- Si el pago es válido: se emite el boleto, se confirma la reservación y los lugares se marcan como vendidos.
- Si el pago no se confirma: los asientos vuelven a estar disponibles y se notifica al comprador.
Sin intervención humana. Sin esperas. Sin riesgo de comprobantes falsos.
La integración técnica: un solo endpoint REST
Una llamada POST es suficiente para validar cualquier comprobante SPEI:
curl -X POST https://api.apicep.cloud/validate-transfer \\
-H \"Authorization: Bearer TU_API_KEY\" \\
-H \"Content-Type: application/json\" \\
-d '{
\"imageUrl\": \"https://tuplataforma.com/uploads/comprobante-123.jpg\",
\"beneficiary\": {
\"clabe\": \"TU_CLABE_18_DIGITOS\",
\"bank\": \"NOMBRE_DE_TU_BANCO\",
\"name\": \"Tu Teatro o Productora\"
}
}'
La respuesta incluye todo lo necesario para tomar la decisión de emisión automáticamente:
{
\"status\": \"valid\",
\"confidence\": 0.98,
\"extracted\": {
\"amount\": 1200.00,
\"senderName\": \"María García López\",
\"date\": \"2026-05-01\"
},
\"validation\": {
\"banxicoConfirmed\": true
},
\"downloads\": {
\"cepPdf\": \"https://api.apicep.cloud/files/cep-xxx.pdf\",
\"cepXml\": \"https://api.apicep.cloud/files/cep-xxx.xml\"
}
}
Regla crítica: siempre verificar status === \"valid\" y validation.banxicoConfirmed === true antes de emitir el boleto — un HTTP 200 no garantiza que el pago sea válido.
Documentación completa en apicep.cloud/documentacion.
Lógica de emisión de boletos con validación SPEI
En tu backend, la lógica de decisión se ve así:
async function procesarPagoSPEI(orderId, imageUrl) {
const order = await getOrder(orderId);
const validation = await fetch('https://api.apicep.cloud/validate-transfer', {
method: 'POST',
headers: { 'Authorization': `Bearer ${process.env.APICEP_API_KEY}` },
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 isValid = validation.status === 'valid'
&& validation.validation?.banxicoConfirmed === true
&& validation.extracted?.amount >= order.total;
if (isValid) {
await emitirBoletos(orderId);
await liberarAsientos(orderId);
await enviarConfirmacion(order.email);
await guardarCEP(orderId, validation.downloads);
} else if (validation.status === 'pending') {
await marcarOrdenPendiente(orderId);
} else {
await liberarAsientosTemporal(orderId);
await notificarErrorPago(order.email);
}
}
Casos específicos en eventos en vivo
Preventa y alta demanda
Cuando los últimos lugares se venden en minutos, la validación automática permite procesar múltiples pagos simultáneos sin que ninguno quede en cola esperando revisión manual.
Funciones con asientos numerados
Si el comprador reservó asientos específicos, el tiempo entre la reserva temporal y la confirmación del pago es crítico. Con apiCEP el ciclo cierra en segundos, no en horas.
Taquilla presencial con opción SPEI
Para organizaciones que operan taquilla física donde algunos compradores prefieren transferir en lugar de pagar con tarjeta, la validación automática permite confirmar el pago frente al comprador sin hacer una llamada ni esperar estado de cuenta.
Abonos y membresías de temporada
Cuando el comprador paga una temporada completa por SPEI, el sistema puede validar el comprobante y activar todos los accesos programados automáticamente desde la misma lógica.
CEP oficial: respaldo para auditorías y disputas
Cada validación exitosa genera los links al Comprobante Electrónico de Pago (CEP) oficial de Banxico en XML y PDF. Para una plataforma de boletos, esto tiene un valor práctico directo:
- Ante una disputa de cargo: tienes el documento oficial que prueba que la transferencia ocurrió, con timestamp y firma digital de Banxico.
- Para conciliación contable: el XML del CEP contiene todos los campos necesarios para integrarse automáticamente a sistemas de contabilidad o ERP.
- Para el comprador: puedes entregarle el CEP oficial junto con sus boletos como comprobante de la operación completa.
Los archivos permanecen disponibles por 15 días — tiempo suficiente para descargarlos y almacenarlos en tu sistema.
Comparativa: con y sin validación automática
| Aspecto | Sin apiCEP | Con apiCEP |
|---|---|---|
| Tiempo para emitir boleto tras SPEI | Minutos a horas | Menos de 15 segundos |
| Riesgo de comprobante falso | Alto (revisión visual) | Eliminado (Banxico confirma) |
| Capacidad en picos de demanda | Limitada por personal | Ilimitada (automática) |
| Asientos reservados sin pago real | Posible | Imposible |
| Respaldo oficial de cada cobro | No | CEP en XML y PDF |
| Disponibilidad | Horario del equipo | 24/7 |
Precios sin contratos ni mensualidades
| Plan | Precio | Validaciones | Costo por validación |
|---|---|---|---|
| Bienvenida | Gratis | 50 | — |
| Básico | $100 MXN | 200 | $0.50 MXN |
| Premium | $200 MXN | 800 | $0.25 MXN |
| Business | $400 MXN | 1,600 | $0.25 MXN |
Para una plataforma que emite 300 boletos al mes con pago SPEI, el plan Premium cubre toda la operación a $0.25 MXN por validación — menos del 3% del costo de un boleto de $12 MXN.
Empieza con 50 validaciones gratuitas
Si tu plataforma de venta de boletos ya acepta SPEI y hoy dependes de revisión manual para confirmar cada pago, apiCEP puede automatizar ese proceso desde hoy.
Crea tu cuenta en apicep.cloud — las primeras 50 validaciones no tienen costo. Revisa la documentación técnica completa y decide si encaja en tu sistema antes de comprometerte con cualquier plan.