Pruebas antes de producción

Antes de pasar a producción, recorre esta lista en PRE. Es una guía para que tú mismo valides la integración; no hay que enviarnos nada, pero si algo falla te ayudaremos a resolverlo.

Flujo correcto

• Obtienes la lista de países y localizas tu destino por code.
• La disponibilidad devuelve un plan para un país, una fecha y una duración, con su token.
• Haces un prebooking con ese token y el número de eSIM que quieras.
• El prebooking devuelve el importe (pricePerCard, totalPrice, currency) y su pricePerCard coincide con el price.totalPrice de la disponibilidad.
• Confirmas la venta con los datos del titular y recibes un locator y el mismo totalPrice del prebooking.
• Consultas el detalle de la reserva con el locator: ves el estado, las eSIM y el desglose de importes, y su price.totalPrice coincide con el de la confirmación.
• Descargas el voucher desde la voucherUrl y el PDF se abre correctamente con su QR.

Casos límite

• Sin resultados: una búsqueda sin plan devuelve [] y tu aplicación lo trata como “sin disponibilidad”, no como un error.
• Fecha pasada: una startDate anterior a hoy devuelve 400 y tu aplicación lo muestra bien.
• Token no válido: un prebooking con un token inventado devuelve 400 INVALID_TOKEN y tu aplicación repite la búsqueda de disponibilidad.
• Credenciales erróneas: devuelve 401 y tu aplicación no reintenta en bucle.
• Reintento de la confirmación: repites el booking con el mismo prebookingId y obtienes el mismo locator, sin una segunda venta.
• Venta ajena o inexistente: el detalle de un localizador que no es tuyo devuelve 404 SALE_NOT_FOUND.
• Voucher ajeno: abrir la voucherUrl de una venta que no es tuya devuelve 404.
• Datos del titular inválidos: un documentType desconocido devuelve 400 VALIDATION_ERROR con el campo en errors.

Robustez

• Gestionas los 503 y los 5xx con reintentos y espera creciente.
• Tomas las decisiones según code, no según el texto de detail.
• Interpretas las fechas con hora (saleDate, activationDate…) con su zona horaria (terminan en Z, UTC) y no como hora local.
• El secreto no aparece en logs, ni en el repositorio, ni en el navegador de tus clientes.
• Defines un tiempo de espera razonable en tus llamadas (por ejemplo 30 segundos).

Paso a producción

Precaución

No hagas pruebas de confirmación (POST /v1/booking) en producción: cada una crea una venta real. Valida todo en PRE y, en producción, limita las pruebas a las consultas (países y disponibilidad).

Cuando todo esté validado, avisa a tu contacto de WelcomeSims: te entregaremos las credenciales de producción. La URL base de PRO la tienes en Entornos y URLs.