Entregas
Como a MinePag entrega cada benefício no Minecraft, no Discord, no Telegram e em serviços externos, e o que acontece quando algo falha.
Toda compra aprovada passa pelo mesmo caminho: cada benefício do produto vira um acesso liberado do cliente, e cada acesso liberado gera uma ou mais entregas no canal certo. Você acompanha tudo em Entregas › Todas as entregas, no painel da loja.
Como funciona
O pagamento é confirmado
O gateway avisa a MinePag, que confere o status na API do gateway antes de liberar qualquer coisa. O mesmo vale para o primeiro pagamento de uma assinatura; as renovações mantêm os acessos já liberados.
Cada benefício vira um acesso liberado
O cliente ganha um acesso liberado para cada benefício do produto comprado: um cargo, um grupo, um comando, um download. O acesso fica Ativo até ser revogado ou expirar, quando o benefício tem duração.
Cada acesso gera as entregas
A MinePag cria uma entrega por destino. Um comando configurado para dois servidores Minecraft gera duas entregas; dois cargos do Discord geram duas entregas. Cada entrega entra na fila do canal.
O canal executa e confirma
O canal executa a entrega e devolve o resultado: Entregue, Nova tentativa agendada ou Tentativas esgotadas. Benefícios como Acesso a conteúdo e Serviço não geram entrega: o acesso liberado já basta.
Canais
| Canal | Como funciona |
|---|---|
| Minecraft | O plugin MinePag busca os comandos pendentes no servidor, executa no console e confirma cada execução. |
| Discord | O bot da MinePag dá e remove cargos no seu servidor do Discord. |
| Telegram | O bot da MinePag envia um convite de uso único e remove o cliente do grupo ou canal quando o acesso termina. |
| Serviço externo | Um sistema seu recebe o evento delivery.requested por webhook e confirma pela API. |
| Download | O cliente baixa os arquivos na área do cliente, com limite de downloads e validade. |
| Chave de licença | O cliente recebe chaves do estoque de licenças do produto. |
| Reenvia ao cliente, por e-mail, as informações de um acesso. |
Estados de uma entrega
| Estado | O que significa |
|---|---|
| Na fila | A entrega está aguardando a vez, ou esperando o cliente (por exemplo, entrar no servidor ou vincular a conta). |
| Em processamento | O canal está executando a entrega. Inclui serviços externos que ainda não confirmaram. |
| Entregue | O canal confirmou a entrega. |
| Nova tentativa agendada | A tentativa falhou por um motivo temporário e será repetida com intervalo crescente. |
| Tentativas esgotadas | As tentativas acabaram ou a falha é definitiva. Corrija a causa e reprocesse pelo painel. |
| Cancelada | A entrega deixou de ser necessária, por exemplo porque o acesso foi revogado antes. |
Esperas que não gastam tentativa
Algumas entregas dependem do cliente e ficam Na fila sem consumir tentativas:
- Minecraft: um comando que exige o jogador online espera ele entrar no servidor. Se faltar espaço no inventário, a entrega espera ele liberar.
- Discord e Telegram: o cargo ou o convite só sai depois que o cliente vincula a conta. Assim que ele vincula, as entregas pendentes rodam na hora.
Novas tentativas
Quando um canal falha por um motivo temporário (Discord fora do ar, limite de requisições, serviço externo que respondeu com erro), a MinePag tenta de novo com intervalo crescente: 30 segundos, 1 minuto, 2 minutos e assim por diante, até 6 horas entre tentativas. Cada canal tem um número máximo de tentativas:
| Canal | Tentativas |
|---|---|
| Minecraft | 12 |
| Discord | 8 |
| Telegram | 8 |
| Serviço externo | 6 |
| 6 | |
| Download | 5 |
| Chave de licença | 10 |
Falhas definitivas não esperam: um cargo que não existe mais, um bot sem permissão, um comando bloqueado ou recusado pelo servidor do Minecraft vão direto para Tentativas esgotadas. Nesse caso, a MinePag avisa o proprietário e os administradores da loja por notificação e registra o evento nos logs de auditoria.
Para corrigir e tentar de novo, veja Acompanhar entregas.
Pedidos pagos são sempre entregues
Mesmo com uma fatura da MinePag vencida ou o limite de gastos atingido, as entregas de pedidos já pagos continuam normalmente.
Revogação
Em cada benefício, você escolhe quando o acesso é revogado: quando o pedido for reembolsado, quando o pagamento for contestado ou quando o pedido ou a assinatura for cancelado. Todas as opções vêm ligadas. O fim de uma assinatura e o fim da duração de um benefício também encerram o acesso.
Só o reembolso total revoga acessos. Um reembolso parcial mantém o acesso do cliente.
A revogação também vira entrega, e só roda onde a concessão chegou a ser executada:
- Minecraft: executa os comandos de revogação do benefício.
- Discord: remove o cargo.
- Telegram: remove o cliente do grupo ou canal.
- Download e chave de licença: bloqueia novos downloads e revoga as chaves.
- Serviço externo: recebe o evento
entitlement.revoked, se estiver inscrito nele.
Entregas de concessão que ainda não rodaram são canceladas. Você também pode revogar um acesso manualmente na página da entrega.
Guias
Minecraft
Instale o plugin, pareie o servidor e configure o config.yml.
Comandos do Minecraft
Marcadores, jogador offline, inventário e comandos de revogação.
Discord
Conecte o bot e escolha os cargos.
Telegram
Conecte o bot aos grupos e canais privados.
Vincular contas
Como o cliente liga o nick, o Discord e o Telegram à conta dele.
Serviços externos
Entregue por um sistema próprio, com webhook e confirmação pela API.
Packs com marca d'água
Cópias identificadas por comprador e inspetor de vazamento.
Acompanhar entregas
Reprocessar, marcar como entregue, cancelar e reenviar.