Checklist de certificação
Processo para certificar que a integração de um parceiro com a Wholesalers API funciona corretamente antes do acesso à produção.
Endpoints a validar
Seção intitulada “Endpoints a validar”O processo de certificação valida o uso correto do fluxo de reserva completo:
- Token
- HotelRates
- HotelCheckRates
- BookingHold
- BookingNew
- BookingGet
- BookingDelete
Casos de teste obrigatórios (logs a enviar)
Seção intitulada “Casos de teste obrigatórios (logs a enviar)”Test 1 — Busca multi-hotel
Seção intitulada “Test 1 — Busca multi-hotel”Busque dois hotéis simultaneamente em uma única chamada a /hotels/rates.
- Verifique se ambos os hotéis retornam tarifas.
- Verifique se o
rateKeyde cada hotel é único.
Test 2 — Um quarto com adulto e menor
Seção intitulada “Test 2 — Um quarto com adulto e menor”Reserva de 1 quarto com 1 adulto e 1 menor de 17 anos.
- O array de pax contém:
[{age: 30+}, {age: 0-16}]. - Verifique se a tarifa reflete corretamente a idade do menor.
- Conclua o fluxo de reserva completo até
BookingNew.
Test 3 — Três quartos, configuração mista
Seção intitulada “Test 3 — Três quartos, configuração mista”Reserva de 3 quartos:
- 2 quartos com 2 adultos cada
- 1 quarto com 2 adultos + 1 menor de 7 anos
- Verifique se o rateKey multi-quarto é retornado.
- Verifique se o valor é igual à soma dos 3 quartos.
- Conclua
BookingHoldeBookingNew.
Test 4 — Quatro quartos, configuração complexa
Seção intitulada “Test 4 — Quatro quartos, configuração complexa”Reserva de 4 quartos:
- 1 quarto: 1 adulto + 1 menor de 3 anos
- 1 quarto: 2 adultos + 1 menor de 5 anos
- 1 quarto: 1 adulto apenas
- 1 quarto: 1 adulto + 2 menores (de 1 e 2 anos)
- Verifique se todas as combinações são precificadas corretamente.
- Conclua o fluxo de reserva completo.
Test 5 — Encontrar uma reserva existente
Seção intitulada “Test 5 — Encontrar uma reserva existente”Use BookingGet para recuperar uma reserva criada em qualquer teste anterior.
- Verifique se o
bookingIdretornado corresponde. - Verifique
status: CONFIRMED. - Verifique se uma reserva
CONFIRMEDcomhotels[].confirmationCodevazio é tratada como confirmada. - Verifique se os dados de
cliente do hotel retornados pelo BookingGet correspondem ao que você enviou. Não espere que os nomes de pax enviados no HotelRates sejam retornados — ver BookingGet.
Test 6 — Cancelar uma reserva
Seção intitulada “Test 6 — Cancelar uma reserva”Use BookingDelete em uma reserva criada em testes anteriores.
- Aguarde ao menos 90 segundos após a criação antes de cancelar.
- Verifique a resposta
status: CANCELLED. - Verifique se as políticas de cancelamento foram aplicadas corretamente.
Critérios de validação
Seção intitulada “Critérios de validação”A PT validará a integração do parceiro contra:
- Precisão de preços: a tarifa sobe/desce corretamente ao alterar a configuração de pax.
- Correção de cancelamentos: as reservas podem ser canceladas dentro da janela de política aplicável.
- Tratamento de status: o parceiro interpreta corretamente CONFIRMED / CANCELLED / CREATED.
- Tratamento de erros: o parceiro trata com elegância as respostas 4xx e 5xx.
- Disciplina de janelas de tempo: o parceiro respeita as janelas de 60 min / 20 min / 5 min / 90 s.
O que enviar à PT
Seção intitulada “O que enviar à PT”Para cada caso de teste, envie logs contendo:
- Requisição completa (URL, headers excluindo a autenticação sensível, body)
- Resposta completa (headers e body)
- O
eventIdde cada resposta - Timestamp de cada chamada
- Qualquer mensagem de erro encontrada
Falhas de certificação comuns
Seção intitulada “Falhas de certificação comuns”| Falha | Causa raiz |
|---|---|
| Valor não corresponde no Test 3/4 | O parceiro soma tarifas de quarto individual em vez de usar o rateKey multi-quarto |
| O cancelamento do Test 6 falha | O parceiro cancela dentro do cooldown de 90s |
| Resultado da reserva indefinido | O parceiro reinicia o fluxo antes de consultar o BookingGet com um bookingId numérico conhecido ou de entrar em contato com a PT quando esse ID não está disponível. |
| Certificação no ambiente errado | Os testes foram executados fora do ambiente de Integration |
| Token re-solicitado por chamada | O parceiro não faz cache do token e atinge os rate limits |
Pós-certificação
Seção intitulada “Pós-certificação”- São emitidas credenciais de produção (
client_id,client_secretdo ambiente de Production). - É habilitado o channel ID específico do parceiro em Production.
- Opcional: é provisionado um subdomínio dedicado (p. ex.
ptapi-{partner}.pricetravel.com).

