Pacotes de Viagem

Pacotes de viagem sao pacotes pre-pagos unicos que fornecem aos clientes creditos de viagem incluindo tempo, desbloqueios e distancia. Diferente das assinaturas que renovam automaticamente, pacotes de viagem sao comprados uma vez e consumidos ate esgotarem.

Visao Geral

Pacotes de viagem permitem que os clientes paguem antecipadamente por um pacote de creditos de viagem que podem usar em uma ou mais viagens. Isso e ideal para usuarios ocasionais que querem pre-pagar por conveniencia ou economizar dinheiro comparado ao preco por viagem.

Principais Recursos

• Compra unica - Sem cobranças recorrentes ou renovacao automatica
• Consumo flexivel - Use creditos em multiplas viagens ate esgotar
• Tempo incluido - Minutos de viagem incluidos (unidades configuraveis: minutos, horas, dias)
• Desbloqueios gratis - Isencao opcional da taxa de desbloqueio
• Cota de distancia - Quilometros incluidos opcionais
• Minutos de pausa - Tempo de pausa incluido opcional
• Suporte a viagem em grupo - Pacotes podem suportar multiplos usuarios (max_riders)
• Escopo por localizacao - Pacotes podem ser especificos de localizacao ou globais
• Pagamento via carteira ou cartao - Clientes podem pagar do saldo da carteira ou cartao de credito

Pacotes de Viagem vs. Assinaturas

Acessando Pacotes de Viagem

Configuracao do Pacote

Informacoes Basicas

Titulo (i18n)

O nome de exibicao mostrado aos clientes, com traducoes para multiplos idiomas.

Boas Praticas:

• Inclua o beneficio principal (tempo/desbloqueios) no titulo
• Mantenha titulos concisos (2-4 palavras)
• Use nomenclatura consistente entre pacotes

Descricao (i18n)

Descricao estendida opcional explicando os beneficios do pacote.

Numero da Etapa

Controla a ordem de exibicao no aplicativo movel.

Numeros menores aparecem primeiro. Destaque seus pacotes de melhor valor ou mais populares primeiro.

Precificacao

Preco (Centavos)

O valor que os clientes pagam pelo pacote, armazenado em centavos.

Dicas de Precificacao:

• Calcule economia vs. pagar por viagem
• Ofereca proposta de valor clara
• Considere pontos de preco psicologicos (R$ X,99)

Beneficios Incluidos

Tempo Incluido

O beneficio principal - tempo de viagem incluido no pacote.

Exemplos:

• 60 minutos = 1 hora de viagem
• 2 horas = 120 minutos de viagem
• 1 dia = 24 horas de viagem

Incluir Taxa de Desbloqueio

Se o pacote cobre a taxa de desbloqueio.

Quando habilitado, o campo max_riders determina quantos desbloqueios gratis estao incluidos.

Distancia Incluida (Opcional)

Quilometros de distancia incluidos no pacote.

Minutos de Pausa Incluidos (Opcional)

Minutos de tempo pausado incluidos.

Suporte a Viagem em Grupo

Max Riders

Numero de usuarios simultaneos que o pacote suporta.

Personalizacao Visual

Texto do Badge

Badge opcional para destacar o pacote.

Icone

Identificador de icone opcional para o pacote.

E Popular

Flag para indicar que esta e uma escolha popular, pode afetar o estilo de exibicao.

Limites de Velocidade

Velocidade Maxima (kph)

Limite de velocidade opcional aplicado durante viagens usando este pacote.

Util para pacotes de iniciantes ou ofertas focadas em seguranca.

Criando um Pacote de Viagem

Passo 1: Configuracao Basica

1. Navegue ate Precos → Pacotes de Preco de Viagem
2. Clique em Adicionar Pacote
3. Defina Numero da Etapa para ordem de exibicao
4. Insira Titulo nos idiomas suportados

Passo 2: Precificacao

1. Insira Preco em centavos (ex: 4999 para R$ 49,99)
2. Selecione Moeda (normalmente corresponde ao padrao da subconta)

Passo 3: Cota de Tempo

1. Insira Quantidade de Tempo Incluido (ex: 60)
2. Selecione Unidade de Tempo Incluido (minutos, horas ou dias)

Passo 4: Beneficios Adicionais

1. Ative Incluir Taxa de Desbloqueio se o pacote cobre desbloqueios
2. Defina Max Riders se suportar viagens em grupo
3. Adicione Distancia Incluida se aplicavel
4. Adicione Minutos de Pausa Incluidos se aplicavel

Passo 5: Personalizar e Ativar

1. Adicione Texto do Badge opcional
2. Ative Ativado para disponibilizar
3. Clique em Salvar

Como os Pacotes Funcionam

Fluxo de Compra

Uso Durante Viagens

Quando um cliente com um pacote ativo inicia uma viagem:

1. Sistema verifica compras de pacotes ativos
2. Beneficios aplicados - Taxa de desbloqueio isenta (se incluida), tempo comeca a contar contra o pacote
3. Durante a viagem - Tempo/distancia deduzidos das cotas do pacote
4. Viagem termina - Creditos restantes atualizados, excesso cobrado normalmente

Consumo do Pacote

Pacote: 60 Minutos
├── Viagem 1: 15 minutos → 45 minutos restantes
├── Viagem 2: 20 minutos → 25 minutos restantes
├── Viagem 3: 30 minutos → Pacote esgotado (5 min cobrados normalmente)
└── Status: Consumido

Quando um pacote e esgotado, o preco regular se aplica a qualquer uso excedente.

Integracao com Aplicativo Movel

Exibicao do Pacote

A tela /packages do aplicativo movel mostra:

• Pacotes disponiveis para a localizacao do cliente
• Titulo do pacote (localizado)
• Preco formatado para a moeda
• Duracao/tempo incluido
• Indicador de viagem em grupo (se max_riders > 1)
• Botao de compra

Pacotes Ativos

Os clientes podem visualizar seus pacotes ativos:

• Nome do pacote e data de compra
• Tempo/desbloqueios restantes
• Localizacao onde o pacote se aplica
• Historico de uso

Resolucao de Localizacao

Os pacotes sao especificos por localizacao:

1. O app envia as coordenadas GPS do cliente
2. O sistema verifica quais zonas contem a localizacao
3. Os pacotes da subconta correspondente sao exibidos
4. Se ambiguo, o cliente pode precisar selecionar a localizacao

Referencia da API

GET /api/mobile/packages

Busca pacotes disponiveis para uma localizacao.

Parametros de Query:

• lat - Latitude (opcional)
• lng - Longitude (opcional)
• subaccount_id - ID da subconta diretamente (opcional)

Resposta:

{
  "data": {
    "purchases": [...],
    "available_packages": [...],
    "has_active_package": false,
    "location": {
      "subaccount_id": "uuid",
      "subaccount": { "name": "Nome da Cidade" }
    }
  }
}

POST /api/mobile/packages

Compra um pacote.

Corpo da Requisicao:

{
  "package_id": "uuid",
  "payment_method": "wallet"
}

Resposta (pagamento via carteira):

{
  "data": { ... registro da compra ... },
  "payment": {
    "method": "wallet",
    "amount_cents": 4999,
    "new_wallet_balance_cents": 7501
  }
}

Resposta (pagamento com cartao necessario):

{
  "requires_payment": true,
  "client_secret": "pi_..._secret_...",
  "payment_intent_id": "pi_...",
  "amount_cents": 4999
}

Esquema do Banco de Dados

Tabela: ride_pricing_packages

Tabela: ride_pricing_package_purchases

Cenarios Comuns

Cenario 1: Pacote Basico de Tempo

Objetivo: Pacote simples de 1 hora de viagem

Configuracao:

• Titulo: "Pacote 1 Hora"
• Preco: R$ 49,99 (4999 centavos)
• Tempo: 60 minutos
• Incluir Desbloqueio: Sim
• Max Riders: 1

Valor para o Cliente: Economiza vs. taxa de desbloqueio + tarifa por hora

Cenario 2: Passe de Grupo para o Dia

Objetivo: Passeio em familia/amigos

Configuracao:

• Titulo: "Passe de Grupo Diario"
• Preco: R$ 149,99 (14999 centavos)
• Tempo: 4 horas
• Incluir Desbloqueio: Sim
• Max Riders: 4
• Badge: "MELHOR PARA GRUPOS"

Valor para o Cliente: 4 pessoas podem andar juntas compartilhando o tempo

Cenario 3: Pacote de Distancia

Objetivo: Pacote de passeio/exploracao

Configuracao:

• Titulo: "Explorador 50km"
• Preco: R$ 124,99 (12499 centavos)
• Tempo: 2 horas
• Distancia: 50 km
• Incluir Desbloqueio: Sim

Valor para o Cliente: Bom para passeios com limite de distancia

Boas Praticas

Design de Pacotes

1. Proposta de valor clara - Deixe a economia obvia
2. Opcoes escalonadas - Pacotes pequeno, medio, grande
3. Corresponda casos de uso - Trabalho, recreacao, turismo
4. Opcoes de grupo - Familias, amigos, turistas

Estrategia de Precos

1. Calcule ponto de equilibrio - Quando o pacote economiza dinheiro?
2. Precificacao ancora - Mostre equivalente por minuto
3. Valor do pacote - Combine tempo + desbloqueios + pausa

Otimizacao de Exibicao

1. Melhor valor primeiro - Use step_number estrategicamente
2. Use badges - Destaque popular/recomendado
3. Descricoes claras - Explique o que esta incluido

Resolucao de Problemas

Pacote Nao Visivel

1. Verifique se activated e verdadeiro
2. Verifique se deleted_at e null
3. Confirme que a subconta correta esta selecionada
4. Verifique se a localizacao do cliente corresponde a subconta do pacote

Creditos Nao Sendo Aplicados

1. Verifique se o status da compra e 'active'
2. Confirme que os creditos restantes nao sao zero
3. Confirme que a subconta do pacote corresponde a localizacao da viagem
4. Revise logs de calculo de preco da viagem

Problemas com Viagem em Grupo

1. Verifique a configuracao max_riders
2. Verifique se viagens em grupo estao habilitadas nas configuracoes da subconta
3. Confirme que o pacote tem desbloqueios restantes