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.

Escopo de Dispositivo

O escopo de dispositivo controla em quais tipos de dispositivos a parcela pode ser utilizada:

Escopo Significado
Computador Utilizável somente em PCs clientes.
Console Utilizável somente em consoles de jogos.
Ambos Utilizável em qualquer dispositivo. Este é o padrão.

O escopo de dispositivo é herdado por todos os créditos de carteira e créditos de tempo criados a partir deste pacote. O membro vê o escopo no histórico de compras dele no Painel do Membro.

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 da semana 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". O seletor de dias vai de segunda-feira a domingo. Deixar todos os dias marcados significa sem restrição. Pelo menos um dia deve permanecer marcado.

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 Permitir gasto entre categorias no pacote controla se os créditos criados permitem gasto fora da sua categoria:

  • Desligado (padrão): Os fundos são restritos à sua categoria designada.
  • Ligado: O saldo de bônus deste pacote pode ser gasto em qualquer categoria de carteira, não apenas na sua própria.

Acumulação de Desconto de Membro

A opção Combinar com 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:

  • Desligado (padrão): O desconto de nível do membro não acumula. O pacote é tratado como uma oferta de valor fixo.
  • Ligado: 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 o escopo de dispositivo e a 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:

  1. Abra a página Campanhas pela barra lateral e vá para a aba Pacotes.
  2. Clique em Adicionar Pacote.
  3. Na seção Definição, dê um nome ao pacote e escolha a campanha à qual ele pertence.
  4. Na seção Conteúdo, configure o tipo do pacote (minutos ou dinheiro), o valor base, o tipo de bônus opcional com o seu valor do bônus e o preço de compra (o valor que o membro pagará).
  5. Na seção Restrições, escolha o escopo de dispositivo, defina a categoria de carteira com o gasto entre categorias se você usa separação de carteira por categoria e defina a preferência de desconto de membro.
  6. Na seção Validade, opcionalmente defina dias válidos e dias da semana válidos para ofertas por tempo limitado.
  7. Revise a frase de resumo em linguagem simples no rodapé da caixa de diálogo. Ela repete o que o cliente paga e o que recebe, incluindo bônus, validade e restrições.
  8. Salve o pacote.

Gerenciando Pacotes

A aba Pacotes lista todos os pacotes com a sua campanha, conteúdo, preço, valor unitário, validade e escopo de dispositivo. Uma linha de contagem mostra quantos pacotes estão cadastrados e quantos estão ativos. Os pacotes podem ser pausados e retomados. Excluir um pacote o desativa para que os clientes não possam mais comprá-lo, enquanto as compras existentes e o histórico são preservados. Os pacotes nunca são removidos permanentemente.