apiCEP
    ES|EN
    Volver al blog

    Cómo eliminar el botón de 'Notificar Pago' de tu SaaS y activar servicios automáticamente con SPEI

    El botón de "Notificar Pago" es un síntoma

    Si tu plataforma tiene una página de notificación de pago para transferencias bancarias, tienes un problema de automatización — aunque hoy no lo parezca.

    El flujo es conocido: el cliente contrata tu servicio, elige pagar por transferencia SPEI, hace el depósito y luego tiene que regresar a tu sitio, buscar el botón de "notificar pago", subir o escribir los datos del comprobante y esperar a que alguien del equipo lo confirme. Solo entonces se activa su cuenta o se renueva su servicio.

    Ese proceso tiene un costo real: tickets de soporte ("mi pago no se ha aplicado"), clientes que se van a la competencia porque tardaste en activar, y horas de tu equipo revisando comprobantes que deberían procesarse solos.

    apiCEP elimina esa fricción validando el comprobante SPEI automáticamente contra Banxico y activando el servicio sin que nadie intervenga.

    Por qué el proceso manual persiste en servicios digitales

    La razón es simple: las tarjetas de crédito y OXXO tienen confirmación automática porque la pasarela de pagos cierra el ciclo. La transferencia bancaria no tiene ese cierre automático — el dinero llega, pero nadie le avisa a tu sistema.

    La solución estándar es pedirle al cliente que "notifique" su pago. Funciona, pero introduce fricción en ambos lados: el cliente tiene que hacer un paso extra que no esperaba, y tu equipo tiene que procesar manualmente cada notificación antes de activar.

    Para servicios de hosting, dominios, suscripciones SaaS, licencias o cualquier servicio digital recurrente, ese proceso no escala bien cuando el volumen de clientes crece.

    Cómo funciona apiCEP para servicios de activación automática

    apiCEP recibe la imagen del comprobante SPEI, la procesa con OCR y verifica la transferencia directamente contra Banxico en menos de 10 segundos.

    El nuevo flujo para una plataforma de hosting o SaaS:

    1. El cliente elige el plan y selecciona "pagar por transferencia SPEI".
    2. El sistema muestra la CLABE y el monto exacto.
    3. El cliente hace la transferencia y sube el comprobante directamente en la misma pantalla (sin ir a otra página).
    4. Tu sistema pasa la imagen a apiCEP automáticamente.
    5. apiCEP valida contra Banxico y devuelve el resultado.
    6. Si el pago es válido, el servicio se activa o renueva al instante — sin que nadie lo revise.
    7. El cliente recibe el correo de confirmación de activación en segundos.

    El botón de "Notificar Pago" desaparece. El proceso queda tan fluido como un pago con tarjeta.

    La integración técnica: un endpoint REST

    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-inv-8821.jpg\",
    \"beneficiary\": {
      \"clabe\": \"TU_CLABE_18_DIGITOS\",
      \"bank\": \"NOMBRE_DE_TU_BANCO\",
      \"name\": \"Tu Empresa S.A. de C.V.\"
    }
  }'

    La respuesta incluye todo lo necesario para decidir si el servicio se activa:

    {
  \"status\": \"valid\",
  \"confidence\": 0.97,
  \"extracted\": {
    \"amount\": 1499.00,
    \"senderName\": \"Juan Hernández 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 que status === \"valid\", validation.banxicoConfirmed === true y que extracted.amount coincida con la factura antes de activar — un HTTP 200 no garantiza pago válido.

    Documentación completa en apicep.cloud/documentacion.

    Lógica de activación automática en tu backend

    async function procesarPagoSPEI(invoiceId, imageUrl) {
  const invoice = await getInvoice(invoiceId);

  const result = 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 pagoConfirmado =
    result.status === 'valid' &&
    result.validation?.banxicoConfirmed === true &&
    result.extracted?.amount >= invoice.total;

  if (pagoConfirmado) {
    await activarServicio(invoice.clientId, invoice.serviceId); // activa hosting, dominio o plan
    await marcarFacturaPagada(invoiceId, result.validationId);  // registra pago con ID de validación
    await guardarCEP(invoiceId, result.downloads);              // guarda XML y PDF oficial
    await enviarConfirmacionCliente(invoice.clientEmail);       // correo de activación
  } else if (result.status === 'pending') {
    await programarReintento(invoiceId, imageUrl, 300);         // reintenta en 5 minutos
  } else {
    await notificarPagoNoConfirmado(invoice.clientEmail, result);
  }
}

    Casos de uso en servicios digitales recurrentes

    Hosting y dominios

    El cliente renueva su plan anual por SPEI, sube el comprobante y su servicio se renueva automáticamente sin que el equipo intervenga ni el sitio tenga downtime por vencimiento.

    SaaS y plataformas de suscripción

    Usuarios que prefieren no guardar tarjeta y pagan mensualmente por transferencia. Con apiCEP, cada renovación se procesa sola — el cliente transfiere, sube el comprobante y su acceso se mantiene activo al instante.

    Licencias de software

    Activaciones anuales o por período donde el comprobante válida el inicio del ciclo sin revisión manual del equipo de ventas.

    Agencias digitales con clientes que pagan por SPEI

    Proyectos con pagos parciales (anticipo + saldo) donde cada transferencia se valida automáticamente y se registra contra la factura correspondiente.

    Resellers y distribuidores

    Plataformas que tienen revendedores que recargan saldo o pagan facturas por transferencia — apiCEP valida cada pago y actualiza el saldo del reseller automáticamente.

    El impacto en tickets de soporte

    Una de las quejas más comunes en plataformas de hosting y SaaS en México es: "hice mi pago y mi servicio sigue suspendido". Ese ticket existe porque el proceso de activación depende de que alguien revise el comprobante.

    Con validación automática:

    • El tiempo entre comprobante subido y servicio activo baja de horas a segundos
    • Los tickets de "¿por qué no se ha activado mi pago?" desaparecen
    • El equipo de soporte puede enfocarse en problemas técnicos reales, no en procesar comprobantes

    CEP oficial: respaldo contable y de auditoría

    Cada validación exitosa genera los links al CEP oficial de Banxico en XML y PDF. Para plataformas de servicios digitales esto tiene valor concreto:

    • Conciliación automática: el XML del CEP contiene todos los campos para integrarse a tu sistema contable o ERP.
    • Facturación: puedes generar el CFDI de cada pago con los datos oficiales del CEP como respaldo.
    • Disputas: si un cliente disputa un cargo o niega haber pagado, el CEP es el documento oficial que resuelve el caso.

    Los links del CEP permanecen activos 15 días — tiempo suficiente para descargar y almacenar cada archivo en tu sistema.

    Comparativa: proceso manual vs. automatizado con apiCEP

    | Aspecto | Notificación manual | Con apiCEP |
    |---|---|---|
    | Pasos para el cliente | Pagar → ir a otra página → notificar | Pagar → subir comprobante en pantalla |
    | Tiempo de activación | Minutos a horas | Menos de 15 segundos |
    | Revisión del equipo | Necesaria por cada pago | Cero |
    | Riesgo de comprobante falso | Alto | Eliminado (Banxico confirma) |
    | Activación fuera de horario | No | Sí, 24/7 |
    | Respaldo oficial por pago | No | CEP en XML y PDF |
    | Tickets de soporte por pago | Frecuentes | Prácticamente nulos |

    Planes sin contratos ni mensualidades forzosas

    | Plan | Precio | Validaciones | Vigencia |
    |---|---|---|---|
    | Bienvenida | Gratis | 50 | 30 días |
    | Básico | $100 MXN | 200 | 30 días |
    | Premium | $200 MXN | 800 | 30 días |
    | Business | $400 MXN | 1,600 | 30 días |

    Para una plataforma con 300 renovaciones SPEI al mes, el plan Business cubre toda la operación a $0.25 MXN por validación. El ahorro en horas de soporte y revisión manual justifica el costo con cualquier calculadora.

    Empieza con 50 validaciones gratuitas

    Si tu plataforma tiene un proceso de notificación manual para pagos SPEI, apiCEP puede automatizarlo desde hoy.

    Crea tu cuenta en apicep.cloud — las primeras 50 validaciones son sin costo. Prueba la integración con tus facturas reales antes de comprometerte con cualquier plan.