Saltar al contenido principal

Modo pruebas

El modo pruebas deja tu cuenta lista para desarrollar una integración sin efectos reales: los mensajes salientes se simulan, los pagos se bloquean y el OCR de tickets responde con datos de prueba. Los socios y el dinero reales no se tocan.

Es un interruptor de toda la cuenta

No crea un entorno aparte: mientras está activo, toda la cuenta se comporta así, también para el equipo que usa el panel. Actívalo en una cuenta de pruebas o en una ventana de pruebas acordada, y desactívalo al terminar.

Activarlo​

  1. Entra en Administración › Configuración (/app/admin/tenantSettings). Necesitas el permiso Modo de pruebas (Pages.Administration.TenantTestMode) y estar en una cuenta de cliente (la cuenta anfitriona no tiene esta pestaña).
  2. Abre la pestaña Modo de pruebas.
  3. Activa el interruptor Activar modo pruebas y confirma.

Mientras está activo, el panel muestra el aviso El modo pruebas está activo con un enlace Gestionar modo pruebas. Para desactivarlo, apaga el interruptor y confirma: la cuenta vuelve a enviar mensajes reales y a procesar pagos reales.

Qué cambia​

ÁreaComportamiento en modo pruebas
Mensajes (WhatsApp, SMS, correo, push, Telegram)Se simulan: el flujo continúa y el mensaje queda como enviado, pero no se llama a ningún proveedor. El identificador del proveedor empieza por test.
PagosSe rechazan: el cobro de un socio responde 409 con {"error":"test_mode"}, los pagos de cashback quedan retenidos y no se pueden emitir tarjetas regalo de proveedores externos
Llamadas a proveedores de mensajería o dineroCualquiera que escapara de lo anterior se bloquea y se registra
OCR de ticketsResponde con datos de prueba, sin llamar a ningún proveedor ni gastar créditos
API públicaToda respuesta de /api/v1 lleva la cabecera X-IncentIA-Test-Mode: true
Webhooks salientesSe siguen entregando, para que pruebes tu receptor

OCR de prueba​

Incluye un marcador en la URL o el nombre del fichero de la imagen para elegir el resultado:

MarcadorResultado
test_ocr_unreadableLectura fallida: queda para revisión
test_ocr_low_confidenceDatos extraídos con confianza 40: queda para revisión
test_ocr_amount_12.34Ticket legible por ese importe (también vale _ como separador decimal)
(cualquier otro)Ticket legible de 25,50 con confianza 95

Claves de prueba (mk_test_)​

Una clave de prueba empieza por mk_test_ y se comporta como una clave normal con dos diferencias:

  • Solo autentica mientras la cuenta está en modo pruebas. Con el modo desactivado responde 403.
  • No consume la cuota mensual de la API. Los límites por ráfaga, minuto y hora de la clave sí se aplican.

Las claves normales (mk_...) siguen funcionando en modo pruebas; también reciben la cabecera X-IncentIA-Test-Mode, así que puedes comprobar en qué modo estás.

Crear una clave de prueba

El formulario de Administración › Claves API no tiene hoy una casilla para ello. Se crea con la API de administración: POST /api/services/app/ApiKey/CreateApiKey con isTestKey: true (solo en cuentas de cliente). El texto de la pestaña Modo de pruebas indica el prefijo mk_test_.

curl -si "$BASE/api/v1/members/lookup?programId=1&phone=%2B34600111222" \
  -H "Authorization: Bearer mk_test_xxxxxxxx" | grep -i -E "^HTTP|x-incentia-test-mode"
# HTTP/1.1 200 OK
# X-IncentIA-Test-Mode: true

Referencia interactiva​

La referencia OpenAPI de /docs/api-v1 solo envía llamadas con claves mk_test_... de una cuenta en modo pruebas; con una clave real no envía ni la clave ni la llamada. Ver API pública.

Relacionado​