← Ver todo el changelog

v1.0.0

público

Primera versión estable

Primera versión estable de la API y del panel. Una transferencia SPEI se valida a partir de sus datos o de la imagen de su comprobante, y el veredicto llega acompañado del Comprobante Electrónico de Pago (CEP) que emite Banxico. La misma operación está disponible en el panel y en la API.

Validar una transferencia

  • Por captura de datos. La operación se identifica con fecha, monto, clave de rastreo o referencia numérica, banco emisor, banco receptor y cuenta beneficiaria, y con esos datos se busca en Banco de México (Banxico).
  • Por comprobante. La imagen del comprobante, o su dirección https, pasa por reconocimiento óptico de caracteres (OCR), que extrae esos mismos datos. Cuando la cuenta beneficiaria no es legible en la imagen, se envía aparte; si ya está dada de alta como beneficiario, se reconoce a partir de los dígitos visibles.
  • El veredicto. valid: la operación existe en el Comprobante Electrónico de Pago (CEP). not_found: no aparece. cep_unavailable: Banxico reconoce la operación pero todavía no publica el comprobante. error: falla interna del servicio.
  • El comprobante oficial. Una validación con veredicto valid permite descargar el CEP tal como lo emite Banxico, en XML o en PDF.
  • Reintentos automáticos. Un veredicto sin comprobante admite reintento, porque el CEP puede publicarse más tarde. La política fija el número de intentos, el intervalo (de 300 a 86 400 segundos) y los veredictos que lo disparan (not_found, cep_unavailable o error), en toda la cuenta o en una validación concreta. Un reintento no consume cuota.

El panel

  • Validaciones. El historial, el detalle de cada operación con la imagen asociada y la exportación a archivo. La carga masiva acepta CSV, XLSX, XLS, TXT y JSON con plantilla, texto libre, imágenes sueltas o un ZIP de imágenes, y admite un solo trabajo abierto a la vez.
  • Beneficiarios. Cuentas CLABE, tarjetas y celulares DiMo, con la estructura comprobada al darlos de alta y con importación masiva desde archivo.
  • Finanzas. Estado de cuenta mensual en PDF, XLSX, CSV o HTML; reportes mensual, por contraparte, por banco y contable; y la descarga de todos los comprobantes en un archivo comprimido.
  • Notificaciones. Cinco canales —correo electrónico, SMS, push, Telegram y avisos dentro de la aplicación— configurables evento por evento, con horario de silencio.
  • Consumo. Cuota del mes, historial, desglose y mapa de calor de la actividad de la cuenta.

La API

  • Una sola envoltura. Toda respuesta se compone de data, errors y meta, de modo que el código que la interpreta se escribe una vez y sirve para el resto de las operaciones.
  • Clave de API por cuenta. Se revela con una comprobación adicional y se regenera bajo demanda: la clave anterior deja de ser válida en ese momento y la cuenta recibe un aviso de seguridad.
  • Idempotencia. El header Idempotency-Key evita que una petición repetida cree una segunda validación, con una ventana de 24 horas. Una respuesta 5xx no se almacena, de modo que un fallo del servidor no inutiliza la clave.
  • Modo asíncrono. Con ?async=1 la respuesta es un 202 inmediato con el identificador de la validación; el veredicto se recoge sondeando la operación, y el ETag evita descargar dos veces el mismo estado.
  • Webhooks firmados. Once eventos de validación y de facturación, hasta diez por endpoint, con firma HMAC-SHA256 en cada envío, secreto rotable, envío de prueba y registro de entregas.

Planes y cobro

  • Catálogo público. Los planes activos, con sus precios y sus características, se consultan sin sesión.
  • Plan gratuito. Se reclama desde la cuenta, sin tarjeta.
  • Cobro con tarjeta. El cambio de plan, la cancelación, la reanudación y la consulta de facturas ocurren en el portal de facturación, sin intervención de soporte.
  • Excedente. En los planes que lo admiten, la cuenta decide si agotar la cuota detiene el servicio o lo continúa cobrando por consumo.

Seguridad y disponibilidad

  • Saneado de las imágenes. Antes de persistir nada se comprueban el formato real, el tamaño y las dimensiones, y se rechazan las bombas de descompresión y los archivos que además pueden interpretarse como otro formato. Los metadatos —EXIF, XMP e ICC— se eliminan, incluida la ubicación.
  • Protección de la cuenta. Autenticación de 2 factores (2FA) y cierre de todas las sesiones abiertas desde el perfil.
  • Estado del servicio. El estado de la verificación en Banxico se consulta desde la cuenta, con la serie de latencia de las últimas horas.