apiCEP
    ES|EN
    Volver al blog

    Cómo automatizar la verificación de pagos SPEI en tu proveedor de internet (WISP) con apiCEP

    El primer día del mes en un WISP con 400 suscriptores

    El 1 de enero de cada mes, o el primer día hábil, comienza el ciclo más caótico de la operación de cualquier proveedor de internet inalámbrico: los suscriptores pagan su mensualidad.

    En un WISP con 400 clientes activos, eso significa recibir hasta 350-380 comprobantes de transferencia SPEI entre el día 1 y el día 5 del mes. Algunos llegan por WhatsApp, otros por el portal del cliente, otros por correo. El operador — que suele ser también el soporte técnico, el instalador y el administrador — tiene que revisar cada uno antes de registrar el pago en el sistema y decidir si el suscriptor mantiene su servicio o no.

    Ese proceso, repetido mes a mes, es el cuello de botella más predecible de toda la operación de un WISP en México.

    apiCEP lo automatiza.

    El costo real de verificar comprobantes manualmente en un ISP

    El problema no es solo el tiempo — es la combinación de tiempo + consecuencias operativas + riesgo de fraude:

    El tiempo concentrado en pocos días. Los pagos de mensualidades no llegan distribuidos a lo largo del mes. Se concentran en los primeros 5 días. Un operador que revisa 380 comprobantes en 5 días está dedicando más de 75 imágenes por día solo a ese proceso — antes de atender fallas de red, instalaciones o soporte.

    Las decisiones de corte de servicio dependen de la verificación. Si un suscriptor no ha pagado y el sistema no tiene registrado el pago, el WISP suspende el servicio. Si el cliente sí pagó pero el operador no había procesado su comprobante todavía, el corte fue incorrecto — genera reclamos, desconfianza y trabajo adicional para restituir.

    Los comprobantes falsos existen en ISPs también. Un suscriptor que sabe que su internet será cortado el día 5 tiene incentivo para mandar un comprobante editado y ganar días. Sin verificación contra Banxico, ese comprobante pasa la revisión visual sin problemas.

    El fin de semana y los días festivos desregulan el ciclo. Si el día 1 cae en sábado, los pagos llegan el fin de semana y el operador los procesa el lunes — con el sistema de cortes ya activo y clientes reclamando que su servicio fue suspendido aunque ya pagaron.

    Cómo funciona apiCEP para proveedores de internet

    apiCEP recibe la imagen del comprobante SPEI, la valida contra Banxico en menos de 10 segundos y devuelve si el pago es real, el monto exacto y la clave de rastreo oficial.

    Para un WISP, el flujo automatizado funciona así:

    1. El suscriptor hace su transferencia y sube el comprobante en el portal del cliente.
    2. El portal pasa la imagen a apiCEP automáticamente.
    3. apiCEP valida contra Banxico en segundos.
    4. Si el pago es válido y el monto corresponde a la mensualidad:
      • El sistema registra el pago automáticamente.
      • El suscriptor mantiene o recupera su servicio sin intervención manual.
      • El suscriptor recibe confirmación inmediata.
    5. Si el pago no se confirma: el sistema notifica al suscriptor que el comprobante no pudo verificarse y le pide uno nuevo.

    El operador ya no revisa comprobantes — el sistema los valida solos.

    La integración técnica: un endpoint para cada comprobante

    curl -X POST https://api.apicep.cloud/validate-transfer \\
  -H \"Authorization: Bearer TU_API_KEY\" \\
  -H \"Content-Type: application/json\" \\
  -d '{
    \"imageUrl\": \"https://tuportal.com/uploads/comprobante-cliente-4821-mayo.jpg\",
    \"beneficiary\": {
      \"clabe\": \"TU_CLABE_18_DIGITOS\",
      \"bank\": \"NOMBRE_DE_TU_BANCO\",
      \"name\": \"Tu WISP o ISP\"
    }
  }'

    Respuesta en segundos con todo lo que tu sistema necesita para registrar el pago:

    {
  \"validationId\": \"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",
  \"status\": \"valid\",
  \"confidence\": 0.97,
  \"extracted\": {
    \"amount\": 399.00,
    \"senderName\": \"Carlos Mendoza Ríos\",
    \"date\": \"2026-05-01\"
  },
  \"validation\": {
    \"banxicoConfirmed\": true,
    \"cepStatus\": \"LIQUIDADA\"
  },
  \"cepDetails\": {
    \"operationDate\": \"2026-05-01T08:22:11\",
    \"trackingKey\": \"2026BBVA0000334455\",
    \"amount\": 399.00
  },
  \"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\", validation.banxicoConfirmed === true y extracted.amount >= mensualidad del suscriptor antes de registrar el pago.

    Documentación completa en apicep.cloud/documentacion.

    Lógica de registro automático de mensualidades

    async function procesarPagoMensualidad(suscriptorId, imageUrl) {
  const suscriptor = await getSuscriptor(suscriptorId);
  const mes        = getMesPeriodo(); // ej. \"2026-05\"

  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 montoValido =
    result.status === 'valid' &&
    result.validation?.banxicoConfirmed === true &&
    result.extracted?.amount >= suscriptor.mensualidad;

  if (montoValido) {
    await registrarPago(suscriptorId, mes, result.validationId);
    await reactivarServicio(suscriptorId);       // si estaba suspendido, reactivar
    await extenderVigencia(suscriptorId, mes);   // actualizar fecha de corte
    await notificarSuscriptor(suscriptorId,
      `✅ Tu pago de $${result.extracted.amount} fue confirmado. Tu servicio está activo.`
    );
    await guardarCEP(suscriptorId, mes, result.downloads);
  } else if (result.status === 'pending') {
    await notificarSuscriptor(suscriptorId,
      '⏳ Tu transferencia está en proceso. En unos minutos se confirmará automáticamente.'
    );
    await programarReintento(suscriptorId, imageUrl, 300); // reintenta en 5 min
  } else {
    await notificarSuscriptor(suscriptorId,
      '❌ No pudimos confirmar tu pago. Asegúrate de subir el comprobante correcto.'
    );
  }
}

    El caso crítico: decisiones de corte basadas en pagos confirmados

    La lógica de suspensión de servicio en un WISP es directa: si el suscriptor no pagó su mensualidad antes del día de corte, el servicio se suspende. Con verificación manual, esa decisión tiene un margen de error alto:

    • El suscriptor pagó el día 4 a las 11pm, el operador no procesó el comprobante hasta el día 5 en la tarde, el corte automático ya corrió.
    • El suscriptor manda un comprobante editado, el operador lo acepta visualmente, no se hace el corte, el servicio sigue activo sin pago real.

    Con apiCEP, el corte de servicio puede basarse en datos verificados contra Banxico, no en si alguien revisó o no la imagen:

    // Determinar estado de pago para decisiones de corte
async function evaluarEstadoPagoSuscriptor(suscriptorId, mes) {
  const pagos = await getPagosMes(suscriptorId, mes);

  // Si tiene al menos un pago validado por Banxico ese mes, el servicio continúa
  const pagoConfirmado = pagos.some(p =>
    p.banxicoConfirmed === true &&
    p.cepStatus === 'LIQUIDADA' &&
    p.amount >= p.suscriptorMensualidad
  );

  return pagoConfirmado ? 'activo' : 'pendiente_de_corte';
}

    Escala: de 50 a 2,000 suscriptores sin cambiar el proceso

    La validación con apiCEP es automática — no hay diferencia operativa entre procesar 50 comprobantes o 2,000 al mes. El sistema valida cada uno en segundos sin que el operador intervenga.

    Para un WISP en crecimiento, eso significa que el proceso de verificación de pagos no escala con el número de suscriptores. No necesitas contratar a alguien para revisar comprobantes cuando llegas a 500 clientes, ni a 1,000.

    El único límite es el plan de apiCEP — y el plan Business ($400 MXN/mes) cubre 1,600 validaciones, suficiente para un WISP con 1,600 suscriptores mensuales a $0.25 MXN por validación.

    WhatsApp como canal de pago: también automatizable

    Muchos suscriptores de internet rural y semi-urbano no usan portales web — mandan su comprobante directamente por WhatsApp al número del proveedor. Con un bot de WhatsApp conectado a apiCEP (usando YCloud u otra API Business), ese canal también se automatiza:

    1. El suscriptor manda el comprobante por WhatsApp.
    2. El bot detecta que es una imagen y la pasa a apiCEP.
    3. apiCEP valida contra Banxico.
    4. El bot responde automáticamente al suscriptor con la confirmación.
    5. El sistema registra el pago y actualiza el estado del servicio.

    Una integración, dos canales cubiertos: portal del cliente y WhatsApp.

    CEP como respaldo ante disputas de suscriptores

    Cuando un suscriptor reclama que pagó pero su servicio fue cortado, o cuando un suscriptor disputa que se le cobró doble, el CEP oficial de Banxico resuelve la disputa con datos irrefutables. El CEP tiene el monto exacto, el timestamp, los datos bancarios del emisor y la firma digital de Banco de México.

    Con apiCEP, cada pago validado genera automáticamente los links al CEP en XML y PDF. Guárdalos asociados a cada suscriptor y mes.

    Comparativa: verificación manual vs. automática con apiCEP

    | Aspecto | Verificación manual | Con apiCEP |
    |---|---|---|
    | Tiempo por comprobante | 2–5 minutos | Menos de 15 segundos |
    | Concentración de trabajo días 1-5 | Pico crítico para el operador | Procesamiento automático distribuido |
    | Riesgo de comprobante falso | Alto | Eliminado (Banxico confirma) |
    | Decisiones de corte incorrectas | Frecuentes | Prácticamente nulas |
    | Pagos del fin de semana | Represados hasta el lunes | En tiempo real, 24/7 |
    | Escala con más suscriptores | Requiere más personal | Automático, sin costo adicional de operación |
    | Respaldo ante disputas de suscriptores | Solo la imagen del comprobante | CEP oficial XML + PDF |
    | cepStatus: \"LIQUIDADA\" disponible | No | Sí — estatus definitivo de Banxico |

    Planes sin contratos ni mensualidades forzosas

    | Plan | Precio | Validaciones | Costo por validación | Suscriptores cubiertos |
    |---|---|---|---|---|
    | Bienvenida | Gratis | 50 | — | Prueba inicial |
    | Básico | $100 MXN | 200 | $0.50 MXN | Hasta 200 suscriptores/mes |
    | Premium | $200 MXN | 800 | $0.25 MXN | Hasta 800 suscriptores/mes |
    | Business | $400 MXN | 1,600 | $0.25 MXN | Hasta 1,600 suscriptores/mes |

    Para un WISP con 300 suscriptores, el plan Premium cubre toda la operación mensual a $0.25 MXN por validación — $75 MXN al mes para eliminar completamente la revisión manual de comprobantes.

    Empieza con 50 validaciones gratuitas

    Si tu WISP o ISP hoy verifica comprobantes SPEI manualmente antes de registrar pagos y decidir cortes, apiCEP puede automatizar ese proceso desde hoy.

    Crea tu cuenta en apicep.cloud — las primeras 50 validaciones son sin costo. Sin RFC. Sin contrato. Prueba con los comprobantes reales de tus suscriptores antes de comprometerte con cualquier plan.