Conheça o ClickOferta

Este é um recurso exclusivo para parceiros, consulte a disponibilidade juntamente com seu executivo de contas.


O que é?

ClickOferta é uma solução exclusiva de tarifas baixas da Clickbus. Ele permite que usuários encontrem e comprem passagens com preços reduzidos em datas específicas.

Fluxo de criação de pedido

O fluxo de criação de pedido se mantém o mesmo, porém com a inteção de um pedido com ClickOferta, o campo isLowFare deve ser obrigatóriamente preenchido como true, pois seu estado default é isLowFare=false.

  1. 🔍 Pesquisar Viagens: Execute GET /v5/trips com os parâmetros de busca
  2. 📋 Selecionar Viagem: Escolha uma viagem e obtenha seu UUID
  3. ℹ️ Mapa de Assento com ClickOferta: Use GET /v4/trips/{uuid}?isLowFare=true
  1. 💺 Bloquear Assentos: Execute POST /v4/trips/{id}/seats para reserva temporária
  2. ✅ Finalizar Compra: Processe o pagamento através do sistema externo

Impactos

Payload do bloqueio de assento

CampoDescrição
isLowFare: trueNo objeto dentro do array seats

Exemplo payload (trecho relevante)

{
  "seats": [
    {
      "label": "{{label}}",
      "isLowFare": true
    }
  ]
}

Payload do pedido

CampoDescrição
isLowFare: trueNo objeto do ticket dentro do array orderItems

Exemplo payload (trecho relevante)

"orderItems": [
         {
            "type": "ticket",
            "isLowFare": true,
            "meta": {
                "id": "{{seatId}}",
                "amount": {{amount}},
                "tripTypeDirection": "{{tripTypeDirection}}",
                "tripLeg": {{tripLeg}},
                "passenger": {
                    "documentType": "{{documentType}}",
                    "documentNumber": "{{documentNumber}}",
                    "name": "{{name}}"
                }
            }
        }
    ]

Response criação de pedido

Dentro da resposta do pedido, além dos itens contratados como ticket, insurance e service_fee, ao marcar o ticket com isLowFare: true, virá um objeto referente ao ClickOferta identificado como low_fare.

Exemplo response (trecho relevante)

"item": [
        [...]
        {
            "id": 1234,
            "type": "low_fare",
            "status": "COMPLETE",
            [...]
        }
    ],