Documentación Oficial de la API

Bienvenido a la documentación de AICEP TECH. Integra la validación automática de pagos SPEI y lectura de comprobantes con Inteligencia Artificial en tus aplicaciones.

Autenticación

Todas las llamadas a la API requieren una API Key activa enviada en la cabecera Authorization como Bearer token:

Authorization: Bearer aicep_live_xxxxxxxxxxxxxxxxxxxxxxxx

1. Validar Comprobante con IA (Imagen)

Sube una imagen de cualquier captura bancaria. La IA extraerá los datos y consultará a Banxico en un solo paso.

Ejemplo con cURL (Subiendo archivo de imagen):

curl -X POST https://aicep.tech/api/v1/validar-comprobante.php \
  -H "Authorization: Bearer TU_API_KEY" \
  -F "comprobante=@captura_transferencia.jpg"

Ejemplo con cURL (Enviando JSON Base64):

curl -X POST https://aicep.tech/api/v1/validar-comprobante.php \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_base64": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."}'

Respuesta JSON de éxito:

{
  "status": "success",
  "verificado_banxico": true,
  "estado_spei": "LIQUIDADA",
  "datos_extraidos": {
    "clave_rastreo": "BNET01002305080004928172",
    "monto": 250.00,
    "fecha": "2026-10-17",
    "banco_emisor": "BBVA",
    "banco_receptor": "NU"
  },
  "suscripcion": {
    "cliente": "Pizzas Vitors",
    "plan": "Negocio",
    "consultas_usadas": 14,
    "limite_mensual": 1500,
    "vencimiento": "2026-11-17 23:59:59"
  }
}

2. Consulta Directa a Banxico CEP (SPEI)

Si ya cuentas con la clave de rastreo alfanumérica y deseas verificar directamente si el dinero ya cayó en Banxico:

curl -X POST https://aicep.tech/api/v1/consultar-spei.php \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "clave_rastreo": "BNET01002305080004928172",
    "fecha": "2026-10-17",
    "monto": "250.00"
  }'