HandyCafe Docs
owner

Pacotes

Pacotes definem a parcela específica que um membro recebe ao fazer uma compra de uma campanha. Cada pacote especifica o que o membro paga, o que recebe em troca (minutos, crédito de carteira ou ambos), em quais dispositivos a parcela se aplica e por quanto tempo permanece válida.

Tipos de Pacote

Todo pacote possui dois campos de tipo que determinam a natureza da parcela:

Tipo do Pacote

O tipo do pacote define a parcela principal:

  • Minutos: O membro recebe um bloco de minutos pré-pagos. O valor base representa o número de minutos incluídos. Na compra, o sistema cria um crédito de tempo com essa quantidade de minutos.
  • Dinheiro: O membro recebe crédito de carteira. O valor base representa o valor em unidades menores de moeda (ex.: centavos). Na compra, o sistema cria um crédito de carteira com esse saldo.

Tipo de Bônus

O tipo de bônus define uma parcela secundária opcional concedida além da base:

  • Minutos: O membro recebe minutos de bônus. O valor do bônus especifica quantos minutos extras são concedidos. Um crédito de tempo separado é criado com o tipo "Bônus".
  • Dinheiro: O membro recebe crédito de carteira de bônus. O valor do bônus especifica o valor do bônus em unidades menores. Um crédito de carteira separado é criado com o tipo "Bônus".
  • Nenhum: Nenhum bônus está incluído neste pacote. O membro recebe apenas a parcela base.

Exemplos de Combinações

Tipo do Pacote Tipo de Bônus O que o membro recebe
minutos nenhum 120 minutos de tempo pré-pago (sem bônus)
minutos minutos 120 minutos pagos + 30 minutos de bônus
dinheiro nenhum 5000 unidades menores de crédito de carteira
dinheiro dinheiro 5000 crédito de carteira pago + 1000 crédito de bônus
dinheiro minutos 5000 crédito de carteira + 60 minutos de bônus
minutos dinheiro 120 minutos + 2000 crédito de carteira de bônus

Preço de Compra vs. Parcela

O preço de compra é o valor que o membro paga no caixa (em unidades menores de moeda). Isso é independente do valor base. Os dois valores não precisam ser iguais.

Por exemplo:

  • Um pacote pode custar 2000 unidades menores (preço de compra) mas conceder 3000 unidades menores de crédito de carteira (valor base). O membro efetivamente recebe 50% de bônus embutido no preço base.
  • Um pacote de minutos pode custar 1500 unidades menores e conceder 120 minutos. O "custo por minuto" é implícito e não precisa corresponder à tarifa padrão por hora.

Essa separação permite que proprietários de lan houses criem pacotes com valor agregado onde a parcela excede o pagamento, tornando os pacotes mais atrativos do que o pagamento avulso.

Restrição de Dispositivo

A restrição de dispositivo controla em quais tipos de dispositivos a parcela pode ser utilizada:

Restrição Significado
Cliente Utilizável em PCs clientes. Também utilizável em consoles.
Console Utilizável em consoles de jogos. Também utilizável em PCs.
Somente PCs Exclusivamente para PCs clientes. Não pode ser usado em consoles.
Somente Consoles Exclusivamente para consoles de jogos. Não pode ser usado em PCs.
Ambos Utilizável em qualquer dispositivo. Este é o padrão.

A restrição de dispositivo é herdada por todos os créditos de carteira e créditos de tempo criados a partir deste pacote.

Período de Validade

Dias Válidos

O campo valid_days define o número de dias que a parcela permanece utilizável após a compra. Quando um membro compra o pacote, o sistema calcula a data de expiração como data_da_compra + valid_days. Após a expiração, qualquer saldo restante (minutos ou crédito de carteira) nos lotes associados não é mais utilizável.

Se valid_days não estiver definido, a parcela não expira.

Dias da Semana Válidos

A configuração de dias válidos é uma seleção opcional de dias que restringe em quais dias da semana a parcela pode ser consumida. Isso permite pacotes como "somente dias úteis" ou "somente fim de semana". Quando os dias válidos são configurados, o sistema só desconta dos créditos do pacote nos dias qualificados.

Categoria de Carteira e Gasto entre Categorias

Pacotes podem atribuir uma categoria de carteira aos créditos de carteira que criam. Isso marca os fundos com um rótulo de categoria (ex.: "jogos", "geral", "alimentação") que restringe onde o saldo pode ser gasto.

A opção de gasto entre categorias no pacote controla se os créditos criados permitem gasto fora da sua categoria:

  • 0 (padrão): Os fundos são restritos à sua categoria designada.
  • 1: Os fundos também podem ser gastos em outras categorias.

Acumulação de Desconto de Membro

A opção de acumulação de desconto de membro controla se o desconto de nível de um membro se aplica além dos preços deste pacote quando os minutos ou crédito de carteira do pacote são consumidos:

  • 0 (padrão): O desconto de nível do membro não acumula. O pacote é tratado como uma oferta de valor fixo.
  • 1: O desconto de nível do membro é aplicado além dos termos do pacote. Isso dá a membros de níveis mais altos economia adicional mesmo ao usar pacotes pré-pagos.

Como os Pacotes são Comprados e Cumpridos

Quando um pacote é comprado:

  1. Cobrança do pagamento: O preço de compra é cobrado do membro (dinheiro, cartão ou dedução de carteira).
  2. Registro de compra: Uma entrada de compra é criada, registrando o membro, pacote, valor pago e timestamps.
  3. Criação de créditos: Com base na configuração do pacote:
    • Se o tipo do pacote é dinheiro: um crédito de carteira é criado com o valor base e tipo de crédito "Pago".
    • Se o tipo do pacote é minutos: um crédito de tempo é criado com o valor base como minutos e tipo de crédito "Pago".
    • Se o tipo de bônus é dinheiro: um crédito de carteira adicional é criado com o valor do bônus e tipo de crédito "Bônus".
    • Se o tipo de bônus é minutos: um crédito de tempo adicional é criado com o valor do bônus como minutos e tipo de crédito "Bônus".
  4. Restrição e validade: Todos os créditos criados herdam a restrição de dispositivo e categoria de carteira do pacote. A expiração é calculada a partir do período de validade se definido.
  5. Rastreamento: O registro de compra mantém totais correntes de consumido vs. concedido para as parcelas paga e bônus, possibilitando cálculos precisos de reembolso se necessário.

Criando um Pacote

Para adicionar um pacote a uma campanha existente:

  1. Abra a campanha na lista de campanhas.
  2. Clique em Adicionar Pacote.
  3. Configure o tipo do pacote (minutos ou dinheiro) e defina o valor base.
  4. Opcionalmente configure o tipo de bônus e o valor do bônus.
  5. Defina o preço de compra (o valor que o membro pagará).
  6. Escolha a restrição de dispositivo.
  7. Opcionalmente defina dias válidos e dias da semana válidos para ofertas por tempo limitado.
  8. Configure categoria de carteira e gasto entre categorias se você usa separação de carteira por categoria.
  9. Defina a preferência de acumulação de desconto de membro.
  10. Salve o pacote.