Bienvenido
La API pública de Verifika — qué hace, dónde sacar la llave y por dónde empezar.
Verifika responde una sola pregunta, y la responde bien: ¿ese pago entró de verdad?
Cruza el comprobante que le muestran a un negocio contra el aviso que el banco manda —por correo o por SMS— y devuelve un veredicto. Esta documentación es para conectar eso a lo que ya tienes: tu bot de WhatsApp, tu ERP, tu software contable, tu panel interno.
Todo vive bajo una sola URL:
https://api.verifika.tech/v1Empieza aquí
Tu primer request
De cero a una respuesta de la API en cinco minutos.
Saca tu llave
Panel → Integraciones → API pública. Permisos, rotación y qué hacer si se filtra.
Referencia
Cada endpoint, con su cuerpo, sus parámetros y sus respuestas.
Verifica desde tu bot
El caso de uso más común, paso a paso.
Qué puedes hacer
| Quiero… | Con esto |
|---|---|
| Saber si un comprobante es real | POST /v1/verifications |
| Anotar un pago que ya sé que entró | POST /v1/incomes |
| Leer el libro de un negocio | GET /v1/incomes y /v1/expenses |
| Registrar gastos y sus categorías | POST /v1/expenses y categorías |
| Enterarme cuando algo pasa, sin preguntar | Webhooks |
| Ver los comprobantes repetidos o falsos | GET /v1/suspicious-attempts |
| Preguntarle a mis datos en lenguaje natural | Servidor MCP |
| Conectar mi asistente sin copiar ningún secreto | Conectar con un clic |
De dónde sale la llave
Toda petición se autentica con una API key del negocio, y solo se crea desde el panel:
Si lo que quieres es conectar un asistente de IA, quizá no necesites llave
Claude y los clientes que hablan el estándar de autorización de MCP se conectan pulsando «Conectar»: te llevan a una pantalla de Verifika, eliges qué conceder y ya está. Sin secretos. Ver Conectar con un clic. Para todo lo demás —un servidor, un bot, un proceso sin persona detrás— sigue siendo una llave, y estos son los pasos.
Entra al panel
app.verifika.tech → Integraciones → pestaña API pública y webhooks.
Crea la llave con los permisos justos
Marca solo lo que tu sistema necesita. Una llave de un bot que registra pagos no necesita poder borrar egresos, y si algún día se filtra, esa diferencia es todo.
Cópiala en ese momento
El secreto se muestra una sola vez. Después solo queda el nombre y los últimos cuatro caracteres. Si lo pierdes, se rota; no se recupera.
Úsala en la cabecera
curl https://api.verifika.tech/v1/me \
-H "Authorization: Bearer $VERIFIKA_API_KEY"/v1/me es el request con el que conviene empezar siempre: dice si la llave sirve, a
qué negocios entra y qué permisos tiene, antes de que un error de permisos te salga a
mitad de un flujo.
Convenciones que aplican a todo
- Montos en pesos enteros.
45000son $45.000. Nunca hay decimales. - Fechas en ISO 8601, UTC.
2026-09-04T15:04:05.000Z. - camelCase en campos y parámetros.
- Listas paginadas por cursor:
limitystartingAfter, conhasMoreynextCursoren la respuesta. Ver Paginación. - Escrituras idempotentes. Manda
Idempotency-Keyy un reintento no cobra dos veces. Ver Idempotencia. - Toda respuesta trae
X-Request-Id. Si algo falla, ese id es lo que soporte necesita.