Conceitos
Os nomes que aparecem no painel, como eles se relacionam e o que cada estado quer dizer.
Como tudo se organiza
- Conta: a sua conta pessoal, com perfil, segurança e sessões.
- Conta de faturamento: quem paga a MinePag. Pertence a uma pessoa, reúne todas as lojas dela e gera uma fatura por mês.
- Loja: a unidade de operação. Cada loja tem catálogo, vitrine, clientes, pedidos, entregas, equipe e gateways próprios.
Uma pessoa pode ser proprietária de várias lojas (todas na mesma conta de faturamento) e participar como membro de lojas de outras pessoas.
Do produto à entrega
| Termo | O que é |
|---|---|
| Produto | O que você vende. Tem um ou mais preços e um ou mais benefícios. |
| Preço | Como o produto é cobrado: pagamento único, recorrente ou "pague quanto quiser". Com opções, cada combinação é uma variante com preço próprio. |
| Benefício | O que o cliente recebe ao comprar: comando no Minecraft, cargo no Discord, acesso no Telegram, download, chave de licença, acesso a conteúdo, serviço externo, serviço ou benefício personalizado. |
| Cliente | Quem compra na loja. Não confunda com usuário, que é quem opera o painel. |
| Pedido | Uma compra feita na loja, com os itens, os descontos e as respostas dos campos de checkout. |
| Pagamento | Uma tentativa de cobrança do pedido no gateway. Um pedido pode ter vários (por exemplo, cartão recusado e depois Pix). |
| Acesso liberado | Um benefício concedido a um cliente por um pedido ou por uma assinatura. |
| Entrega | A execução de um acesso liberado num canal (Minecraft, Discord, Telegram, download, chave de licença ou serviço externo), com novas tentativas automáticas. |
| Assinatura | Cobrança recorrente de um cliente. Mantém os acessos liberados enquanto estiver em dia. |
| Reembolso | Devolução total ou parcial de um pagamento. Pode revogar os acessos liberados. |
| Contestação | Disputa aberta pelo comprador no banco ou na operadora do cartão. |
O caminho de uma venda é sempre o mesmo:
- O cliente paga e o gateway confirma. A MinePag consulta o status direto na API do gateway antes de liberar.
- O pedido fica Pago.
- Cada benefício do produto vira um acesso liberado do cliente.
- Os benefícios com canal geram uma entrega. Os demais (acesso a conteúdo, serviço e personalizado) valem na hora, sem entrega.
- Em reembolso, contestação ou cancelamento, os acessos liberados podem ser revogados, conforme a configuração de cada benefício.
Estados
Os mesmos rótulos aparecem em todo o painel, na API (em inglês, no campo de status) e nos e-mails.
Pedido
| Estado | Quando acontece |
|---|---|
| Pendente | O pedido foi criado e aguarda o pagamento. |
| Pago | O pagamento foi confirmado. Os acessos são liberados. |
| Concluído | O pedido terminou de ser atendido. |
| Cancelado | O pedido foi cancelado antes do pagamento. |
| Expirado | O prazo para pagar terminou (Pix em 30 minutos, boleto alguns dias depois do vencimento). |
| Reembolsado | O valor foi devolvido ao cliente. |
Pagamento do pedido
Aguardando pagamento · Pago · Reembolsado em parte · Reembolsado · Falhou · Cancelado · Contestado.
Acesso liberado
| Estado | O que quer dizer |
|---|---|
| Pendente | O acesso ainda vai ser concedido. |
| Ativo | O cliente tem o benefício. |
| Revogado | O acesso foi retirado (reembolso, contestação, cancelamento ou ação manual). |
| Expirado | A duração configurada no benefício terminou. |
Entrega
| Estado | O que quer dizer |
|---|---|
| Na fila | A entrega aguarda a vez. |
| Em processamento | O canal está executando a entrega. |
| Entregue | O canal confirmou a entrega. |
| Nova tentativa agendada | A tentativa falhou e outra já está marcada. |
| Tentativas esgotadas | Todas as tentativas falharam. Confira o erro e reenvie pelo painel. |
| Cancelada | A entrega não vai mais acontecer (por exemplo, o pedido foi reembolsado antes). |
Assinatura
Pendente · Em teste · Ativa · Em atraso · Pausada · Suspensa · Cancelada · Expirada. Veja Assinaturas.
Produto e vitrine
- Produto: Rascunho · Publicado · Arquivado.
- Vitrine: Não publicada · Publicada · Em manutenção.
Gateway conectado
Validando · Conectado · Credenciais inválidas · Com erro · Desativado. Cada conexão é de Sandbox (teste) ou Produção (dinheiro real).
Conta de faturamento
| Estado | O que quer dizer |
|---|---|
| Teste grátis | Os primeiros 14 dias, sem cartão. |
| Em dia | Nenhuma fatura vencida. |
| Fatura vencida | Há uma fatura vencida há poucos dias. |
| Restrita | Não é possível criar produtos, criar lojas nem alterar configurações. |
| Suspensa | A conta está suspensa por falta de pagamento. |
| Encerrada | A conta foi encerrada. |
Em qualquer estado, pedidos já pagos continuam sendo entregues. Os prazos estão em Fatura vencida.
Sandbox e Produção
- Sandbox usa as credenciais de teste do gateway. Nenhum dinheiro real circula e os pedidos não entram na fatura da MinePag. Na vitrine, só a equipe da loja, logada no painel, consegue pagar em Sandbox; pela API, só a chave secreta.
- Produção usa as credenciais reais. Cada pedido aprovado conta como uso.
Transações importadas
Ao conectar um gateway, a MinePag pode importar o histórico de vendas antigas. Essas transações importadas aparecem em Vendas › Transações e nos Relatórios, mas não geram pedido, entrega nem uso tarifado. Veja Importação de histórico.