v1.0.0
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
validpermite 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_unavailableoerror), 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,errorsymeta, 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-Keyevita que una petición repetida cree una segunda validación, con una ventana de 24 horas. Una respuesta5xxno se almacena, de modo que un fallo del servidor no inutiliza la clave. - Modo asíncrono. Con
?async=1la respuesta es un202inmediato con el identificador de la validación; el veredicto se recoge sondeando la operación, y elETagevita 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.