Modo de prueba

Una llave de prueba (vk_test_…) sirve para que tu desarrollador construya y pruebe la integración contra el negocio real sin tocar sus pagos:

• Lo que es de verdad: la validación de lo que mandas, las guardas de la imagen (https, tamaño, tipo real) y la lectura del comprobante con IA. Es lo que vienes a ver funcionar.
• Lo que es de mentira: el veredicto. No se registra nada en el libro, no se gasta el cupo de verificaciones, no se anota nada en Pagos sospechosos y no se le avisa al dueño ni a su bot.

Crea la llave

Crear una llave de prueba abre el formulario de Crear llave con el interruptor Llave de prueba encendido y el atajo «Registro de pagos» marcado. Ponle un nombre («Pruebas del bot»), revisa los permisos y créala. Como cualquier llave, se muestra una sola vez.

app.verifika.tech/integraciones?seccion=api&crear=1&atajo=registro-de-pagos&modo=prueba

1234

Funciona en el mismo negocio y con los mismos permisos que una real; lo que cambia es el modo, y el modo no se cambia después: para pasar a producción se crea otra llave, real. La lista de llaves las marca con la insignia Prueba.

Los valores mágicos

En modo prueba, el veredicto de POST /v1/verifications lo decide la referencia que mandes en reference (o la que la IA lea en la imagen, si imprimes una). Mayúsculas o minúsculas, da igual:

curl -X POST https://api.verifika.tech/v1/verifications \
  -H "Authorization: Bearer $VERIFIKA_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "imageUrl": "https://cdn.tubot.com/comprobantes/7f3a.jpg",
    "reference": "TEST_PENDING_VERIFIED",
    "metadata": { "chatId": "prueba-1" }
  }'

La imagen se lee de verdad: los datos de extracted son los de tu comprobante. El ingreso que devuelve tiene la forma de siempre, pero un id inc_test_… que solo existe dentro de esa verificación. El contrato de datos (amount) también funciona en prueba, y ahí el phone no se valida contra el equipo.

Qué funciona con una llave de prueba

{
  "error": {
    "code": "TEST_MODE_UNAVAILABLE",
    "message": "Con una llave de prueba (vk_test_) solo se simulan verificaciones: esta operación cambiaría datos reales del negocio. Usa una llave real.",
    "details": { "livemode": false },
    "requestId": "req_5837b3c1d2e04f6a9b1c7d8e0f2a3b4c",
    "docUrl": "https://docs.verifika.tech/docs/guias/errores"
  }
}

Cómo saber en qué modo estás

• GET /v1/me trae livemode: false con una llave de prueba.
• Toda respuesta trae la cabecera Verifika-Livemode (true o false), y con una llave de prueba los objetos llevan además livemode: false.
• Las verificaciones y los webhooks traen livemode.
• En el historial de peticiones del panel, cada petición de una llave de prueba sale con la insignia Prueba, y se pueden filtrar.

app.verifika.tech/integraciones?seccion=api&tab=historial

12

Webhooks de prueba

Los eventos que provocan tus llaves de prueba (verification.verified y verification.not_found de los valores mágicos) solo van a los webhooks que tengan encendido «Recibir también eventos de prueba» (testEvents: true). Está apagado por defecto, a propósito: un manejador de producción que no mire livemode despacharía un pedido por un pago de mentira.

Se enciende en Integraciones → Webhooks, en la pestaña General del formulario. Un mismo webhook puede recibir los dos tipos; distínguelos así:

if (evento.livemode === false) {
  // Evento de prueba: prueba tu flujo, pero no despaches nada.
}

Los eventos de prueba llegan con livemode: false en el cuerpo y la cabecera Verifika-Livemode: false, no cuentan para el tope mensual de entregas y salen marcados como Prueba en el historial de entregas.

Límites

Cada verificación de prueba puede ser una lectura con IA de verdad, y una llave de prueba se pega en tutoriales y en pruebas automáticas. Por eso tiene su propio freno, por llave:

Qué se guarda y por cuánto

Todo lo de prueba vive aparte: las verificaciones, sus ingresos de mentira y las imágenes, en una zona separada de nuestro almacenamiento. Se borra solo a los 7 días. Nada de eso aparece en el panel del negocio, salvo en el historial de peticiones de la API, marcado como prueba.

Pasar a producción

1. Crea una llave real con los mismos permisos.
2. Cámbiala en la configuración de tu sistema (VERIFIKA_API_KEY). El código no cambia.
3. Quita los valores TEST_* que tengas fijos en reference: con una llave real son una referencia cualquiera.
4. Revoca la de prueba si ya no la necesitas.