Benefícios
Configure o que o cliente recebe depois do pagamento e quando o acesso é revogado, tipo por tipo.
Um benefício é o que o cliente recebe ao comprar um produto. Ele é configurado na aba Entrega do produto, no bloco O que o cliente recebe. Quando o pagamento é confirmado, cada benefício vira um acesso liberado do cliente e, se tiver canal, gera uma entrega com novas tentativas automáticas.
Adicionar um benefício
Escolha o tipo
Na aba Entrega, clique para adicionar um benefício. O painel mostra primeiro os Sugeridos para este produto (por exemplo, comandos no Minecraft e cargo no Discord para itens Minecraft) e depois os Outros.
Preencha os dados comuns
| Campo | Para que serve |
|---|---|
| Nome do benefício | Aparece para o cliente no e-mail e na área do cliente. Até 160 caracteres. |
| Vale para | Todos os preços ou um preço específico. Use para entregar coisas diferentes por variante (VIP 30 dias e VIP 90 dias). |
| Observação interna | Só a equipe da loja vê. |
| Revogar o acesso quando | Três chaves, todas ligadas por padrão: O pedido for reembolsado, O pagamento for contestado e O pedido ou a assinatura for cancelado. |
| Benefício ativo | Desligado, o benefício para de ser entregue em novas compras e aparece como Pausado. |
Configure o tipo e salve
Preencha os campos do tipo (veja abaixo) e clique em Adicionar benefício. A MinePag confere se cada destino escolhido existe e pertence à loja.
Cada preço ativo de itens Minecraft, produtos digitais e assinaturas precisa de pelo menos um benefício para o produto ser publicado.
Remover ou pausar não tira o que já foi entregue
Ao remover um benefício, as novas compras deixam de recebê-lo, mas quem já comprou mantém o acesso já liberado. Para retirar um acesso de quem comprou, revogue o acesso liberado no pedido.
Tipos de benefício
| Tipo | Canal de entrega |
|---|---|
| Comando no Minecraft | Minecraft (o plugin busca os comandos) |
| Cargo no Discord | Discord |
| Acesso ao Telegram | Telegram |
| Download | Download |
| Chave de licença | Chave de licença |
| Serviço externo | Serviço externo (webhook) |
| Acesso a conteúdo | Liberado na hora, sem entrega |
| Serviço | Liberado na hora, sem entrega |
| Personalizado | Liberado na hora, sem entrega |
Comando no Minecraft
O plugin MinePag executa os comandos no console do servidor quando o pagamento é confirmado.
| Campo | Regra |
|---|---|
| Comandos de entrega | De 1 a 20 comandos. Cada um vira uma entrega separada e eles rodam na ordem em que aparecem: um comando espera o anterior terminar. Cada um com até 1.000 caracteres, numa linha só. A barra inicial (/) é opcional e removida. |
| Comandos de revogação | Até 20 comandos, executados se o pedido for reembolsado ou contestado, se a assinatura terminar ou for pausada, ou quando a duração do acesso termina. Opcional. |
| Executar em todos os servidores pareados | Ligado por padrão. Desligue para escolher servidores específicos. |
| Esperar o jogador entrar no servidor | Ligado por padrão. Necessário para itens no inventário. Desligue para cash, ranks e permissões. |
| Espaços livres no inventário | De 0 a 36. A entrega espera o jogador liberar espaço. Use 0 para não exigir. |
| Duração do acesso em dias | De 1 a 3.650. Ao fim do prazo, a MinePag roda os comandos de revogação. Vazio para acesso enquanto o pedido ou a assinatura estiver ativo. |
Use estes marcadores nos comandos:
| Marcador | Valor | Exemplo na prévia |
|---|---|---|
{player} | Nick do jogador | Steve |
{uuid} | UUID do jogador | 8667ba71-b85a-4004-af54-457a9734eed7 |
{order} | Número do pedido | 1042 |
{quantity} | Quantidade comprada | 2 |
Qualquer outro texto entre chaves é recusado. Cada comando roda uma vez por servidor, mesmo que o cliente compre mais de uma unidade: use {quantity} para multiplicar.
lp user {player} parent addtemp vip 30d
give {player} diamond {quantity}
broadcast {player} virou VIP!lp user {player} parent remove vipComandos com {player} ou {uuid} exigem o nick no checkout
Se algum comando usa {player} ou {uuid}, o produto precisa de um campo obrigatório do tipo Nick do Minecraft para todos os preços
em que o benefício vale. Itens Minecraft já nascem com esse campo. Veja Campos de checkout.
O jogador que recebe é o nick digitado no checkout (pode ser um presente para outra pessoa). Quando esse nick é o mesmo da conta Minecraft que o cliente vinculou, a entrega usa também o UUID verificado. Veja Vincular contas.
Por segurança, o plugin recusa sempre os comandos op, deop, stop, minepag e mpag, com ou sem prefixo (minecraft:op). O painel não deixa salvar um benefício com eles. Mais detalhes em Comandos do Minecraft.
Cargo no Discord
O cliente recebe um ou mais cargos no seu servidor do Discord depois de vincular a conta do Discord na área do cliente.
| Campo | Regra |
|---|---|
| Cargos concedidos | De 1 a 50 cargos sincronizados do seu servidor. |
| Duração do acesso em dias | De 1 a 3.650. Vazio para acesso enquanto o pedido ou a assinatura estiver ativo. |
Sem o bot conectado, o painel mostra Conectar o Discord. Veja Discord.
Acesso ao Telegram
O cliente recebe um convite de uso único para o grupo ou canal, na conversa com o bot da loja.
| Campo | Regra |
|---|---|
| Grupos e canais | De 1 a 50 destinos em que o bot da MinePag foi adicionado. |
| Duração do acesso em dias | De 1 a 3.650. Vazio para acesso enquanto o pedido ou a assinatura estiver ativo. |
Veja Telegram.
Download
O cliente recebe links de download na Biblioteca da área do cliente.
| Campo | Regra |
|---|---|
| Arquivos | De 1 a 50 arquivos de Catálogo › Arquivos. Arquivos que ainda estão enviando ou falharam aparecem marcados. |
| Limite de downloads | De 1 a 1.000, por arquivo, por compra. Vazio para ilimitado. |
| Validade do link em dias | De 1 a 3.650. Vazio para não expirar. |
| Marca d'água por comprador | Cada cliente recebe uma cópia identificada do arquivo .zip, o que permite rastrear vazamentos. |
Marca d'água entra no uso
Cada entrega com marca d'água conta no uso da fatura, inclusive em pedidos grátis (100 por mês estão incluídas). Veja Packs com marca d'água e os preços.
Veja Arquivos e licenças.
Chave de licença
Uma ou mais chaves do seu estoque de chaves são reservadas para o cliente.
| Campo | Regra |
|---|---|
| Estoque de chaves | Um estoque da loja. Você pode criar um novo direto no benefício, em Novo estoque de chaves. |
| Chaves por unidade comprada | De 1 a 20. Com 2 chaves por unidade e 3 unidades compradas, o cliente recebe 6 chaves. |
Com o estoque vazio, o produto não pode ser publicado. Com poucas chaves, a lista de verificação avisa. Veja Arquivos e licenças.
Serviço externo
Um sistema seu (ou de terceiros) recebe o evento delivery.requested por webhook e confirma a entrega pela API, com POST /api/v1/deliveries/{id}/complete ou /fail.
| Campo | Regra |
|---|---|
| Serviço externo | Um endpoint cadastrado em Entregas › Serviços externos. |
Veja Serviços externos.
Acesso a conteúdo
Libera publicações exclusivas da área Conteúdo da vitrine.
| Campo | Regra |
|---|---|
| Conteúdo liberado | Todo o conteúdo exclusivo ou Só os conteúdos escolhidos (até 500). |
| Duração do acesso em dias | De 1 a 3.650. Vazio para acesso enquanto o pedido ou a assinatura estiver ativo. |
Veja Conteúdo.
Serviço
Para trabalhos que a sua equipe entrega manualmente. O cliente recebe as Instruções para o cliente (até 5.000 caracteres) na página do pedido, aberta pelo link do e-mail de confirmação, e na área do cliente, enquanto o acesso estiver ativo.
Personalizado
Um benefício descrito por você, sem entrega automática. Informe O que o cliente recebe (por exemplo, "Camiseta autografada") e, se quiser, as Instruções para o cliente.
Revogação
Quando um acesso liberado é revogado:
- Minecraft: os comandos de revogação são executados nos servidores em que a concessão aconteceu.
- Discord e Telegram: o cargo é removido ou o acesso ao grupo é retirado.
- Download e conteúdo: os links e as publicações deixam de abrir.
- Chave de licença: as chaves entregues ficam marcadas como revogadas.
- Serviço externo: o serviço recebe os eventos
entitlement.revokedeorder.refundedpor webhook e deve retirar o acesso por conta própria.
O motivo fica registrado: reembolso, contestação, cancelamento, fim da assinatura, assinatura pausada ou ação manual. Quando a duração configurada no benefício termina, o acesso fica Expirado e é retirado nos canais da mesma forma. Detalhes em Reembolsos e contestações.