Pacotes de NFT
Pré-requisitos de acesso
- Permissão (módulo):
manageToken - Licença/Feature: Nenhuma específica (depende da feature de NFTs habilitada no tenant).
- Contêiner do menu: GERAL → grupo Produtos → Pacotes de NFT
O que é / quando usar
Os pacotes trazem uma maneira aleatória de adquirir NFTs (tipo "booster pack"). Cada pacote é composto por NFTs classificados em Bronze, Silver, Gold, Platinum ou Diamond. O operador define quantos pacotes existem, quantos NFTs cada classe traz e quantos NFTs vêm por pacote; na compra, o sistema sorteia os NFTs dentro da classificação configurada.
A empresa define:
- Quantidade de pacotes disponíveis para venda.
- Quais classes compõem o pacote (mínimo 1 tipo).
- Quantos NFTs de cada classe.
- Quantos NFTs por pacote.
O sistema escolhe os NFTs aleatoriamente dentro da classificação. Se o pacote estiver numa categoria, apenas NFTs daquela categoria entram no sorteio. Nunca é possível escolher NFTs específicos, e o sistema não considera se o comprador já possui aquele NFT.
Pré-condições
- Permissão:
manageToken(enum CPM + módulo dinâmico no DB). - Dependências: os NFTs (assets) das classes precisam existir na coleção/categoria; carteiras para comissão precisam existir se forem usadas.
Passo a passo
- Acesse Produtos → Pacotes de NFT.
- A lista mostra nome e valor atual; filtre pela busca.
- Use Criar para abrir o assistente de pacote (seções: Geral, Mídias, Precificação, Carteiras, Publicação).
- Preencha e salve. Em cada linha use Visualizar, Editar ou Excluir.
Campos
| Campo | O que é | Obrigatório? | Efeito no sistema/backend |
|---|---|---|---|
Nome curto (short_name) | Nome do pacote | Sim | Identifica o pacote na loja. |
Descrição (description) | Texto do pacote | Não | Conteúdo comercial. |
Imagem / Mídias (url, photos) | Capa e galeria | Não | Upload via files API. |
Categoria / Coleção (category_id, collection_id) | Restringe o sorteio | Não | Quando definida, só NFTs daquela categoria/coleção entram no pacote. |
Quantidade de pacotes (quantity) | Estoque de pacotes à venda | Sim | Limita as vendas. |
Tamanho do pacote (package_size) | NFTs por pacote | Sim | Quantos NFTs o comprador recebe. |
Composição por classe (packages[]) | Lista {package_type, quantity} (Bronze…Diamond) | Sim | Define o pool de sorteio por classe. |
Mín./Máx. por compra (minimumToBuy, maxToBuy) | Limites por comprador | Não | Restringe a quantidade adquirível. |
Preço (price) | Valor do pacote | Sim | BigNumber. |
Aceitar BNB / Coin (acceptBnb, acceptCoin, bnbPrice, coinPrice, bothMandatory) | Formas de pagamento | Não | Habilita pagamento em BNB e/ou moeda; bothMandatory exige ambos. Preços BigNumber. |
Tipos de pagamento (payment_types[]) | Lista {unitOfMoney, percentage} | Não | Define os tokens aceitos e o rateio. |
Comissão de carteiras (wallets_commission[]) | Lista {id, commission} | Não | Rateia comissão para carteiras específicas. |
Habilitado (enabled) | Pacote ativo | Não | Default true. Excluir, na prática, define enabled=false (soft-delete). |
Ações e modais
- Criar / Editar: assistente em seções. Salvar persiste o
NFTPackage. - Excluir: define
enabled=false(soft-delete viaupdateDetailsPackage) com confirmação por bottom-sheet, e recarrega a lista. - Visualizar: abre o pacote em modo leitura.
Regras de negócio / cuidados
Atenção
- O sorteio é aleatório dentro da classe/categoria — não há como entregar um NFT específico.
- Excluir é soft-delete (
enabled=false), não remoção física; o pacote some da loja mas o histórico permanece.
- Valores financeiros: preço,
bnbPriceecoinPricesão BigNumber — sem arredondamento.