Documentación / Pruebas

Pruebas de integración antes del lanzamiento

Un entorno aislado para comprobar API, accesos, datos de prueba, notificaciones, errores, operaciones repetidas, informes y criterios de preparación sin afectar al sistema de producción.

Ver proceso de integración
Entorno
entorno de pruebas independiente
Datos
jugadores y operaciones
Escenarios
casos correctos y de error
Aceptación
confirmación de preparación
Ciclo de pruebas

De la concesión de accesos a la aceptación

01
Preparar el entorno de pruebas

Endpoints independientes, claves de acceso, notificaciones, reglas de IP y configuración de pruebas.

02
Crear datos de prueba

Jugadores, monedas, saldos, proveedores, métodos y estados predefinidos.

03
Ejecutar escenarios

Comprobaciones correctas, de error, repetidas, retrasadas y de fallo.

04
Confirmar la preparación

Registros, informes, criterios de aceptación, responsables y plan de paso a producción.

Resumen

El entorno de pruebas debe reproducir el comportamiento real de la API

Un entorno de pruebas útil permite repetir escenarios de negocio reales, controlar resultados, investigar cada solicitud y probar errores de forma segura sin afectar a datos de producción ni operaciones financieras.

Entorno aislado

Endpoints de API, claves de acceso, bases de datos, colas, endpoints de notificación y restricciones de acceso independientes.

Datos controlados

Jugadores, saldos, métodos, proveedores y estados predecibles para escenarios repetibles.

Aceptación formal

Escenarios acordados, resultados esperados, informes y responsables de confirmar la preparación.

Entornos y accesos

Separación de los entornos de pruebas y producción

Los entornos de pruebas y producción utilizan endpoints distintos y no comparten claves, usuarios, notificaciones ni datos financieros.

01

Emitir claves de acceso independientes

Las claves de API, los clientes OAuth, los secretos de firma y las cuentas de servicio se crean únicamente para el entorno de pruebas.

02

Configurar endpoints de prueba

El endpoint principal de la API, los endpoints de notificación y retorno, las IP permitidas y la configuración TLS se registran por separado.

03

Restringir las acciones reales

El entorno de pruebas no envía pagos reales, correos electrónicos, SMS, solicitudes KYC ni otras operaciones financieras externas.

04

Documentar las diferencias

Se documentan las diferencias en límites, proveedores, datos, tiempos de procesamiento y escenarios disponibles.

Datos de prueba

Datos de prueba y estados controlados

El equipo sabe de antemano qué datos de entrada producen el resultado necesario y cómo devolver el entorno a su estado inicial.

Jugadores de prueba

Perfiles activos, bloqueados, no verificados, autoexcluidos y otros con estados fijos.

Saldos

Importes disponibles, cero, insuficientes, de bonificación y reservados.

Monedas y precisión

Monedas fiduciarias y digitales, distintas unidades de importe, redondeo y combinaciones no compatibles.

Proveedores

Conexiones disponibles, desactivadas temporalmente, defectuosas y restringidas por mercado.

Juegos y productos

Juego con dinero real, modo demo, restricciones por país, productos desactivados y distintos escenarios de saldo.

Métodos de pago

Operaciones correctas, rechazos, estados pendientes, 3-D Secure, retrasos, reembolsos y pagos.

Verificación de clientes y riesgo

Casos aprobados, pendientes, rechazados, de revisión manual, de alto riesgo y bloqueados.

Restablecimiento de datos

Restablecimiento repetible al estado inicial, creación de nuevas entidades y limpieza de operaciones sin intervención manual.

Escenarios de prueba

Escenarios de prueba obligatorios

El plan prueba el proceso de negocio completo, incluidos errores de red, reenvíos y recuperación de estados, y no solo métodos de API aislados.

Escenarios correctos

El proceso completo desde la primera solicitud hasta el estado final, el asiento financiero y los informes.

Escenarios de error

Datos no válidos, acción prohibida, saldo insuficiente, rechazo, falta de disponibilidad y fallo de validación.

Reintentos y protección frente a duplicados

El mismo ID de operación, ID de evento repetido y devolución segura de un resultado creado previamente.

Retrasos y fallos de conexión

Respuesta lenta, fallo de conexión, notificación retrasada y resultado desconocido de la operación.

Procesamiento fuera de orden

Evento tardío, estado final que llega antes que un estado intermedio y actualización de un objeto obsoleto.

Falta de disponibilidad del sistema

Errores HTTP 5xx, mantenimiento, falta de disponibilidad del proveedor, sobrecarga de la cola y recuperación posterior.

Las pruebas deben ser reproducibles

Los mismos datos de entrada y el modo seleccionado deben producir el mismo resultado para que los equipos puedan volver a probar una corrección.

Registros y controles

Diagnóstico y gestión del entorno de pruebas

Cada escenario debe poder rastrearse mediante el ID de solicitud, evento u operación, u otro identificador estable.

Registros y trazabilidad

El ID de solicitud y el ID de correlación pasan por todos los sistemas participantes.
Se registran la hora, el endpoint, el estado, el código de error y el resultado del procesamiento.
Se puede buscar por jugador, pago, ronda, solicitud o ID de evento.
Los campos sensibles se enmascaran sin perder información útil para el diagnóstico.

Control de escenarios

Se puede seleccionar un resultado correcto o de error predefinido.
Se puede generar un retraso, una notificación repetida, un duplicado o un error del proveedor.
Están disponibles el restablecimiento, el reenvío y la repetición del escenario seleccionado.
Las diferencias entre la simulación y un entorno de pruebas real del proveedor se identifican claramente.
Aceptación y lanzamiento

Aceptación y transición al lanzamiento

Una integración se considera preparada después de confirmar la API, la seguridad, los escenarios de negocio, el diagnóstico y los informes financieros u operativos.

API acordada

Los endpoints, las estructuras de datos, los estados, los errores y las reglas de versionado coinciden con la documentación.

Seguridad

Se han verificado las claves de acceso, las firmas, los roles, las reglas de IP y la protección de datos.

Fiabilidad

Los reintentos, retrasos, notificaciones, cancelaciones y la recuperación se gestionan de forma segura.

Control operativo

Los registros, métricas, alertas de errores y diagnósticos están disponibles para los equipos responsables.

Informes y conciliación

Las operaciones, estados, saldos, informes de proveedores e informes internos producen resultados coherentes.

Confirmación de preparación

Los responsables de producto, desarrollo, pruebas, seguridad y operaciones han confirmado la preparación para el lanzamiento.

Lista de comprobación previa al lanzamiento

Las claves de acceso de producción se emiten después de completar la aceptación y preparar un plan de lanzamiento controlado.

Los entornos de pruebas y producción están completamente separados por endpoints, claves, datos y notificaciones.
Se han completado escenarios correctos, de error, repetidos y de fallo.
Los ID, registros y resultados de procesamiento están disponibles para cada solicitud.
Se han confirmado la protección frente a duplicados, los retrasos y la recuperación.
Los informes, registros financieros y totales de control coinciden.
Se han acordado los accesos de producción, la supervisión, la cancelación de operaciones y los contactos de soporte.

¿Necesita preparar un entorno de pruebas?

Envíenos la documentación, la lista de escenarios de negocio, los entornos disponibles y los requisitos de datos de prueba. APIACE ayudará a definir la estructura de validación, los criterios de aceptación y el plan de transición al lanzamiento.