apiCEP
    Volver al blog

    Cómo verificar automáticamente los pagos SPEI de tus clientes en tu despacho contable

    Gestionas las finanzas de tus clientes. Las tuyas, aún a mano.

    Un contador independiente o despacho contable con 30 clientes recibe, en promedio, entre 30 y 90 transferencias SPEI al mes — honorarios mensuales, pagos de declaraciones, servicios adicionales. Cada una llega como una imagen en WhatsApp o por correo, y alguien tiene que verificar que el pago sea correcto antes de comenzar el trabajo del mes.

    La verificación manual funciona con volumen bajo. Con 30 clientes en período de declaración anual, se convierte en una tarea que compite directamente con el tiempo que deberías dedicar a los mismos clientes que acabas de cobrar.

    apiCEP automatiza esa verificación. El comprobante llega, se valida contra Banxico en segundos, y tu sistema sabe si el mes empieza o no — sin que nadie revise una imagen manualmente.


    El problema específico de los honorarios recurrentes

    Los pagos en un despacho contable tienen características únicas que hacen especialmente costosa la verificación manual:

    Volumen concentrado en fechas fijas. La mayoría de tus clientes pagan entre el 1 y el 5 de cada mes. Eso significa que en esos cinco días recibes el grueso de tus transferencias — exactamente cuando también empiezas a procesar la información del mes anterior.

    Temporada fiscal es temporada de pico doble. Marzo y abril son los meses de mayor carga de trabajo (declaración anual de personas físicas) y también los meses donde más clientes renuevan o contratan servicios. Más pagos que verificar, menos tiempo para verificarlos.

    Un comprobante falso tiene consecuencias directas. Si un cliente manda un comprobante editado y comienzas el trabajo sin verificar, terminaste el mes trabajando sin cobrar. No hay producto físico que recuperar — el servicio ya se prestó.

    La duda del "¿ya viste mi pago?" genera fricción innecesaria. Si no confirmas rápido, el cliente manda ese mensaje. Tú tienes que parar lo que estás haciendo para buscar la imagen y verificarla. Con validación automática, la confirmación le llega al cliente en segundos sin que tú hagas nada.


    Cómo funciona apiCEP en un despacho contable

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

    El flujo automatizado para un despacho:

    1. El cliente hace su transferencia mensual y manda el comprobante por WhatsApp o correo.
    2. Tu sistema (o bot de WhatsApp) recibe la imagen y la pasa a apiCEP automáticamente.
    3. apiCEP valida contra Banxico y devuelve el resultado en segundos.
    4. Si el pago es válido: el sistema registra el pago, marca al cliente como activo para el mes y le envía confirmación.
    5. Si el pago no se confirma: el sistema notifica al cliente que el comprobante no pudo verificarse y solicita uno nuevo.

    Sin revisar imágenes a mano. Sin buscar el comprobante entre 30 conversaciones de WhatsApp. Sin el "¿ya viste mi pago?" a las 9pm.


    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://tusistema.com/uploads/pago-cliente-gomez-mayo.jpg\",
        \"beneficiary\": {
          \"clabe\": \"TU_CLABE_18_DIGITOS\",
          \"bank\": \"NOMBRE_DE_TU_BANCO\",
          \"name\": \"Tu Despacho Contable S.C.\"
        }
      }'
    

    La respuesta incluye todo lo necesario para registrar el pago automáticamente:

    {
      \"status\": \"valid\",
      \"confidence\": 0.98,
      \"extracted\": {
        \"amount\": 3500.00,
        \"senderName\": \"Ana Laura Gómez Ruiz\",
        \"date\": \"2026-05-02\"
      },
      \"validation\": {
        \"banxicoConfirmed\": true
      },
      \"cepDetails\": {
        \"operationDate\": \"2026-05-02T09:14:22\",
        \"trackingKey\": \"2026BBVA0000098765\",
        \"senderRfc\": \"GORAA850101XYZ\",
        \"senderBank\": \"BBVA MEXICO\",
        \"senderAccount\": \"012345678901234567\",
        \"amount\": 3500.00
      },
      \"downloads\": {
        \"cepPdf\": \"https://api.apicep.cloud/files/cep-xxx.pdf\",
        \"cepXml\": \"https://api.apicep.cloud/files/cep-xxx.xml\"
      }
    }
    

    Regla crítica: verificar siempre status === \"valid\" y validation.banxicoConfirmed === true y que extracted.amount coincida con los honorarios del cliente antes de marcarlo como pagado.

    Documentación completa en apicep.cloud/documentacion.


    Lógica de registro automático de pagos

    async function procesarHonorarioCliente(clientId, imageUrl) {
      const client   = await getClient(clientId);
      const periodo  = 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 pagoValido =
        result.status === 'valid' &&
        result.validation?.banxicoConfirmed === true &&
        result.extracted?.amount >= client.honorarioMensual;
    
      if (pagoValido) {
        await registrarPago(clientId, periodo, result);     // marca mes como cobrado
        await activarServicioMes(clientId, periodo);        // habilita acceso al portal
        await enviarConfirmacion(client.email, result);     // \"Tu pago del mes de mayo fue confirmado\"
        await guardarCEP(clientId, periodo, result.downloads); // archivo oficial como respaldo
      } else if (result.status === 'pending') {
        await notificarPendiente(client.whatsapp);          // \"Tu pago está en proceso, espera unos minutos\"
      } else {
        await notificarErrorPago(client.whatsapp, result);  // \"No pudimos confirmar tu pago\"
      }
    }
    

    El valor del senderRfc para despachos contables

    Un dato que otros servicios de validación no entregan y apiCEP sí: el RFC del ordenante — extraído directamente del CEP oficial de Banxico.

    Para un despacho contable, ese campo tiene un valor práctico concreto:

    • Confirmar que pagó quien debía pagar. Si un cliente tiene varios RFC (empresa y persona física), puedes verificar que el pago llegó del RFC correcto.
    • Generar el CFDI de honorarios automáticamente. Con el RFC del cliente ya extraído del CEP, tu sistema puede iniciar el proceso de timbrado de la factura sin que nadie lo teclee manualmente.
    • Auditoría interna. Cada pago queda asociado al RFC exacto que transfirió, no solo al nombre que el cliente puso en la referencia.

    Casos específicos en despachos y contadores independientes

    Honorarios mensuales fijos

    El caso más común: 30 clientes pagan entre el 1 y el 5. Con apiCEP, cada comprobante que llega se valida automáticamente y el cliente recibe su confirmación sin que tú intervengas.

    Pago de declaraciones adicionales

    Cuando un cliente paga por una declaración anual, complementaria o un trámite específico, la validación automática confirma el pago y puede desencadenar el inicio del trámite automáticamente.

    Despachos con portal de clientes

    Si tienes un portal donde los clientes suben documentos y revisan el estado de sus obligaciones fiscales, apiCEP se integra directamente para validar el pago al momento de la carga del comprobante.

    Contadores que trabajan con múltiples empresas del mismo grupo

    Cuando un solo cliente corporativo paga los honorarios de varias empresas en una sola transferencia o en transferencias separadas el mismo día, apiCEP identifica cada operación por clave de rastreo para asignarla al RFC correcto.


    El respaldo oficial que ya deberías tener por cada honorario cobrado

    Cada validación exitosa genera el CEP oficial de Banxico en XML y PDF. Para un despacho contable, ese respaldo tiene valor directo:

    • Como soporte del CFDI de honorarios: el XML del CEP complementa la factura que le emites al cliente con el comprobante oficial de que la transferencia ocurrió.
    • Ante una disputa: si un cliente niega haber pagado un mes, tienes el documento oficial con firma digital de Banco de México que lo acredita.
    • Para tu propia contabilidad: los XML de los CEP de tus ingresos son la base para tu propia declaración como persona física con actividad empresarial o persona moral.

    Los links del CEP permanecen activos 15 días — descárgalos automáticamente con cada validación exitosa.


    Temporada de declaración anual: el momento donde más importa

    Marzo y abril son los meses donde la carga de trabajo en cualquier despacho contable se multiplica. Son también los meses donde más clientes pagan servicios adicionales o renuevan contratos. La combinación es crítica: más pagos que verificar, menos tiempo disponible para verificarlos.

    Con apiCEP, esos meses de alta demanda no cambian el tiempo que dedicas a verificar comprobantes — porque ese tiempo pasa a ser cero.


    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 |
    | Riesgo de comprobante falso | Alto | Eliminado (Banxico confirma) |
    | Confirmación al cliente | Manual, irregular | Automática, inmediata |
    | Pico de trabajo en días 1-5 | Concentrado | Distribuido automáticamente |
    | RFC del cliente en el registro | No disponible automáticamente | Extraído del CEP oficial |
    | Respaldo oficial por cobro | Ninguno | CEP en XML y PDF |
    | Operación fuera de horario | No | Sí, 24/7 |


    Planes sin contratos ni RFC requerido

    | 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 un despacho con 40 clientes que pagan mensualmente, el plan Básico cubre holgadamente toda la operación a $0.50 MXN por validación. El tiempo recuperado en las primeras semanas justifica el costo con cualquier calculadora.


    Empieza con 50 validaciones gratuitas

    Si hoy verificas los pagos de tus clientes revisando imágenes de WhatsApp y correos manualmente, apiCEP puede automatizar ese proceso desde hoy.

    Crea tu cuenta en apicep.cloud — las primeras 50 validaciones son sin costo. Sin RFC requerido. Sin contratos. Solo un correo electrónico para empezar.