← Início

Oficina Studio

Produtos de desenvolvedor: entenda a compra repetível e a entrega do benefício

Por Vagner Luiz da Silva · Revisão editorial em · 5 min de leitura

Ilustração de Roblox: Produtos de desenvolvedor: entenda a compra repetível e a entrega do benefício
Ilustração editorial criada com IA para o Merman Games.
Neste guia

Um produto de desenvolvedor pode representar um benefício comprado repetidamente, como um pacote de moeda interna. O ponto principal é a entrega: a experiência precisa reconhecer a transação correta e conceder o que foi descrito, sem duplicar o resultado quando uma confirmação for repetida.

Descreva exatamente o produto

Esta é uma tela de compra usada como exemplo na documentação oficial. Ela não comprova entrega de produto, valor vigente nem uma compra realizada por nós.

Exemplo oficial de confirmação de compra de produto de desenvolvedor.
Imagem da documentação oficial — Roblox Creator Hub. Reprodução sem alterações. Licença do repositório · CC BY 4.0.

Defina o recurso, a quantidade e onde ele poderá ser usado. “Pacote de 100 moedas da experiência” é mais claro que “vantagem especial”. Não chame a moeda interna de Robux nem prometa que o saldo poderá ser transferido a outro jogo.

Esses números são um exemplo de descrição, não uma oferta do Merman. Antes de vender no seu projeto, confira as regras de monetização e implemente o benefício.

Aviso de compra e confirmação não são a mesma coisa

A documentação descreve ProcessReceipt para processar recibos de produtos de desenvolvedor. O fechamento do aviso de compra, por si só, não comprova pagamento concluído.

Não use uma mensagem enviada pelo cliente como autorização para aumentar o saldo. A decisão de entrega precisa ser validada no servidor conforme a implementação documentada.

Organize a entrega em estados

Uma proposta de desenho é separar: recibo recebido, produto identificado, benefício registrado e confirmação concluída. Se a gravação falhar, a implementação precisa tratar a situação sem anunciar que tudo foi entregue.

Quando a mesma transação reaparecer, a pergunta não é “como dar mais moedas?”, mas “esse benefício já foi registrado?”. Essa distinção evita considerar uma repetição de processamento como nova compra.

Prepare casos de teste antes de ativar vendas

Confira uma compra concluída, uma tentativa cancelada, um produto desconhecido e uma interrupção durante a entrega. Registre o saldo anterior e o benefício esperado em cada caso.

Um botão que abre o aviso não comprova que esses casos funcionam. Se você ainda não consegue explicar como a transação é identificada e salva, complete essa parte antes de oferecer o produto.

O guia não é um sistema de pagamentos pronto

Este artigo explica responsabilidades e perguntas de implementação. Não fornecemos aqui código pronto para produção, auditoria do jogo ou garantia de entrega. Use a documentação completa para implementar persistência e recuperação de falhas.

O Merman não vende esse pacote, não recebe dinheiro do jogador e não modifica sua conta. Regras, preços e resultados pertencem à plataforma e à experiência escolhida.

CasoCritério para conferir
Compra confirmadaBenefício corresponde à descrição
Recibo repetidoNão concede o mesmo benefício duas vezes
Produto desconhecidoNão inventa quantidade de saldo
Falha ao salvarNão declara entrega concluída
Compra canceladaNão concede um benefício como se tivesse sido paga

Fonte para conferir as regras

Documentação oficial da Roblox, consultada em 12/10/2026. Confira a versão vigente antes de comprar ou configurar recursos.

Para a implementação atual, consulte MarketplaceService, incluindo ProcessReceipt e BindReceiptHandler. Esta explicação trata do desenho da entrega, não fornece um sistema pronto para vendas.

Uma matriz de entrega deve distinguir compra e repetição

Imagine, apenas para planejar, um produto que concede cem moedas internas. Duas compras legítimas desse produto não são a mesma situação que receber duas vezes a informação de uma única compra. No primeiro caso, são dois benefícios; no segundo, a entrega precisa continuar correspondendo a uma só transação. O identificador do produto descreve o que foi comprado; não basta, sozinho, para distinguir cada ocorrência de compra.

A referência de MarketplaceService inclui tratamento de recibos e exemplos que usam a identificação da compra para lidar com repetição. Leia o contrato da API escolhida por inteiro. Não misture nomes de decisões, callbacks ou exemplos de interfaces diferentes para montar um sistema de pagamentos por tentativa e erro.

Cenário propostoPergunta que o teste deve responder
Duas transações do mesmo produtoAs duas compras são identificadas separadamente e recebem os respectivos benefícios?
Uma transação processada novamenteO registro anterior impede conceder de novo aquilo que já foi entregue?
Jogador saiu durante o fluxoO sistema consegue retomar a situação sem depender de um painel ainda aberto?
Falha entre atualizar e confirmarHá evidência suficiente para recuperar a entrega sem adivinhar o estado?

Planeje o atendimento antes de receber reclamações

Prepare um roteiro interno para “comprei e não recebi”: localizar a experiência e o produto, identificar o intervalo da ocorrência, comparar o registro da transação com o da entrega e separar ausência de registro de ausência de benefício. Não peça senha, código de autenticação nem acesso à conta. Uma captura do botão de compra não resolve essas perguntas.

No projeto de teste, use rótulos claros para situações simuladas. Dados fabricados para testar uma falha não podem aparecer depois como recibos reais ou prova de compra. Registre também a versão do código examinada: mudar a lógica de entrega e conservar um relatório de teste anterior pode criar uma falsa impressão de validação.

Ao terminar, deixe explícitos os casos que passaram, falharam ou não foram executados. Se não existe procedimento confiável para recuperar uma entrega interrompida, essa parte continua pendente.