Loja online (checkout)
O ambiente público do TrackTickets. É onde o cliente final compra: escolhe a data, seleciona ingressos, adiciona complementos e produtos, se identifica e paga.
Como o cliente chega
- Por slug:
/loja/<slug-da-empresa>. - Por domínio próprio, quando configurado.
- Por link de promotor:
?promoter=CODIGO. - Direto na página de uma atração específica.
O sistema resolve a empresa pelo endereço, carrega o tema (logo, cores, textos) e mostra apenas os dados daquele tenant.
Etapas do checkout
O indicador de progresso mostra cinco passos:
Estados do calendário
| Estado | Quando acontece |
|---|---|
| Disponível | Ocorrência aberta, disponível para venda e com capacidade. |
| Esgotado | Capacidade zerada. |
| Fechado / bloqueado / cancelado | Ocorrência existe, mas não é vendável. |
| Sem ocorrência | Não existe data cadastrada — aparece em cinza. |
| Indisponível para venda | Ocorrência existe e está aberta, mas a venda não foi liberada. |
Quando possível, o calendário mostra o preço “a partir de”, e datas futuras destacam o preço antecipado em relação ao cheio. O carregamento é por mês.
Identificação do comprador
O comprador não usa a mesma conta dos operadores. Ele entra sem senha, por um dos caminhos:
- Código por WhatsApp (opção padrão da tela);
- Código por e-mail;
- CPF;
- Conta Google.
Todo comprador também vira um contato do CRM: o sistema procura por CPF, e-mail ou WhatsApp e, se não encontrar, cria o contato.
Carrinho
- Aceita várias atrações na mesma compra.
- Cada item guarda seu contexto: atração, ocorrência, passaporte ou produto, quantidade, preço unitário e a atração de origem, quando veio como complemento.
- Os itens são agrupados por data e atração.
- Subtotal e total são recalculados a cada mudança.
- A quantidade é limitada pela capacidade da ocorrência.
- Cada item consome a capacidade da sua própria ocorrência.
Complementos e produtos
Depois de escolher a data e os ingressos, o cliente vê a seção de complementos — atrações relacionadas ofertadas para a mesma data — e os produtos disponíveis. O complemento só aparece se estiver disponível na data, com ocorrência aberta, liberada para venda e com capacidade, e respeita o limite de quantidade definido no vínculo.
Pagamento
Os meios disponíveis dependem das integrações configuradas pela empresa. Na loja online, os pagamentos on-line são processados pelo gateway habilitado — a plataforma oferece integração com Cielo (cartão e Pix), além de Stone e Mercado Pago, mais voltados à maquininha do balcão. Também é possível configurar parcelamento: número máximo de parcelas, parcelas sem juros, valor mínimo da parcela e taxa de juros ao mês.
Após a compra
- O cliente vai para a página de confirmação do pedido, acessada por um link com token.
- Os vouchers são gerados assim que o pagamento é aprovado.
- O cliente recebe a confirmação por e-mail e/ou WhatsApp, conforme a configuração da empresa.
- Ele pode acompanhar tudo em Minha conta e adiantar os dados de quem vai entrar pelo pré-check-in.
Regras de negócio
- A loja não edita nada do painel — apenas consome o que foi publicado.
- Nunca se confia apenas na tela. Toda validação crítica é refeita no servidor antes de gravar a venda.
- O preço é recalculado no servidor e o valor enviado pela tela é descartado.
- Sem preço válido não há venda (
price_unavailable). - A venda não é criada se a capacidade acabou, se o tenant é inválido ou se o passaporte está inativo.
- Os vouchers só são gerados após o pagamento aprovado.
- Isolamento entre empresas é absoluto — dados de um tenant nunca aparecem em outro.
- A escrita pública é limitada a criar contato, venda, itens, pagamento e (após aprovação) vouchers.
Estados da loja
| Estado | O que o cliente vê |
|---|---|
| Ativa | A loja normalmente. |
| Inativa | Loja indisponível. |
| Em manutenção | Tela de manutenção. |
| Não configurada | Tema padrão da plataforma. |
| Slug/domínio inexistente | Tela “Loja não encontrada”. |
Erros e dúvidas comuns
| Situação | Motivo | Solução |
|---|---|---|
| Data cinza no calendário | Não existe ocorrência cadastrada | Criar a ocorrência ou aplicar a regra de recorrência |
| Data existe mas não vende | Status diferente de aberta ou “disponível para venda” desligada | Ajustar a ocorrência |
| “Preço indisponível” | Sem preço base e sem regra aplicável | Definir o preço do passaporte |
| Complemento não aparece | Sem ocorrência na mesma data, sem capacidade ou vínculo inativo | Revisar a ocorrência do complemento e o vínculo |
| “Preço alterado, recalcule” | O valor mudou entre o carrinho e a finalização | Confirmar o novo valor com o cliente |
| Loja não encontrada | Slug ou domínio errado | Conferir a configuração da loja |
Boas práticas
- Teste a loja no celular: a maioria das compras acontece nele.
- Mantenha as políticas de compra e cancelamento preenchidas — elas aparecem para o cliente.
- Use a ordem das atrações para destacar o que quer vender primeiro.
- Antes de campanhas, confira a capacidade das datas de pico.