Checklist de certificación
Proceso para certificar que la integración de un partner con la Wholesalers API funciona correctamente antes del acceso a producción.
Endpoints a validar
Sección titulada «Endpoints a validar»El proceso de certificación valida el uso correcto del flujo de reserva completo:
- Token
- HotelRates
- HotelCheckRates
- BookingHold
- BookingNew
- BookingGet
- BookingDelete
Casos de prueba requeridos (logs a entregar)
Sección titulada «Casos de prueba requeridos (logs a entregar)»Test 1 — Búsqueda multi-hotel
Sección titulada «Test 1 — Búsqueda multi-hotel»Busca dos hoteles simultáneamente en una sola llamada a /hotels/rates.
- Verifica que ambos hoteles devuelven tarifas.
- Verifica que el
rateKeyde cada hotel es único.
Test 2 — Una habitación con adulto y menor
Sección titulada «Test 2 — Una habitación con adulto y menor»Reserva de 1 habitación con 1 adulto y 1 menor de 17 años.
- El array de pax contiene:
[{age: 30+}, {age: 0-16}]. - Verifica que la tarifa refleja correctamente la edad del menor.
- Completa el flujo de reserva completo hasta
BookingNew.
Test 3 — Tres habitaciones, configuración mixta
Sección titulada «Test 3 — Tres habitaciones, configuración mixta»Reserva de 3 habitaciones:
- 2 habitaciones con 2 adultos cada una
- 1 habitación con 2 adultos + 1 menor de 7 años
- Verifica que se devuelve el rateKey multi-habitación.
- Verifica que el monto es igual a la suma de las 3 habitaciones.
- Completa
BookingHoldyBookingNew.
Test 4 — Cuatro habitaciones, configuración compleja
Sección titulada «Test 4 — Cuatro habitaciones, configuración compleja»Reserva de 4 habitaciones:
- 1 habitación: 1 adulto + 1 menor de 3 años
- 1 habitación: 2 adultos + 1 menor de 5 años
- 1 habitación: 1 adulto solo
- 1 habitación: 1 adulto + 2 menores (de 1 y 2 años)
- Verifica que todas las combinaciones se cotizan correctamente.
- Completa el flujo de reserva completo.
Test 5 — Encontrar una reserva existente
Sección titulada «Test 5 — Encontrar una reserva existente»Usa BookingGet para recuperar una reserva creada en cualquier test anterior.
- Verifica que el
bookingIddevuelto coincide. - Verifica
status: CONFIRMED. - Verifica que una reserva
CONFIRMEDconhotels[].confirmationCodevacío se trata como confirmada. - Verifica que los datos de
clienty del hotel que devuelve BookingGet coinciden con lo que enviaste. No esperes que se devuelvan los nombres de pax enviados en HotelRates — ver BookingGet.
Test 6 — Cancelar una reserva
Sección titulada «Test 6 — Cancelar una reserva»Usa BookingDelete sobre una reserva creada en tests anteriores.
- Espera al menos 90 segundos después de la creación antes de cancelar.
- Verifica la respuesta
status: CANCELLED. - Verifica que las políticas de cancelación se aplicaron correctamente.
Criterios de validación
Sección titulada «Criterios de validación»PT validará la integración del partner contra:
- Precisión de precios: la tarifa sube/baja correctamente al cambiar la configuración de pax.
- Corrección de cancelaciones: las reservas se pueden cancelar dentro de la ventana de política aplicable.
- Manejo de estados: el partner interpreta correctamente CONFIRMED / CANCELLED / CREATED.
- Manejo de errores: el partner maneja con gracia las respuestas 4xx y 5xx.
- Disciplina de ventanas de tiempo: el partner respeta las ventanas de 60 min / 20 min / 5 min / 90 s.
Qué entregar a PT
Sección titulada «Qué entregar a PT»Por cada caso de prueba, envía logs que contengan:
- Petición completa (URL, headers excluyendo la autenticación sensible, body)
- Respuesta completa (headers y body)
- El
eventIdde cada respuesta - Timestamp de cada llamada
- Cualquier mensaje de error encontrado
Fallos de certificación comunes
Sección titulada «Fallos de certificación comunes»| Fallo | Causa raíz |
|---|---|
| Monto no coincide en Test 3/4 | El partner suma tarifas de habitación individual en vez de usar el rateKey multi-habitación |
| La cancelación del Test 6 falla | El partner cancela dentro del cooldown de 90s |
| Resultado de reserva sin resolver | El partner reinicia el flujo antes de consultar BookingGet con un bookingId numérico conocido o de contactar a PT cuando no dispone de ese ID. |
| Certificación en el entorno equivocado | Los tests se ejecutaron fuera del entorno de Integration |
| Token re-solicitado por llamada | El partner no cachea el token y golpea los rate limits |
Post-certificación
Sección titulada «Post-certificación»- Se emiten credenciales de producción (
client_id,client_secretdel entorno de Production). - Se habilita el channel ID específico del partner en Production.
- Opcional: se provisiona un subdominio dedicado (p. ej.
ptapi-{partner}.pricetravel.com).

