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

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.

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.
| Caso | Critério para conferir |
|---|---|
| Compra confirmada | Benefício corresponde à descrição |
| Recibo repetido | Não concede o mesmo benefício duas vezes |
| Produto desconhecido | Não inventa quantidade de saldo |
| Falha ao salvar | Não declara entrega concluída |
| Compra cancelada | Nã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 proposto | Pergunta que o teste deve responder |
|---|---|
| Duas transações do mesmo produto | As duas compras são identificadas separadamente e recebem os respectivos benefícios? |
| Uma transação processada novamente | O registro anterior impede conceder de novo aquilo que já foi entregue? |
| Jogador saiu durante o fluxo | O sistema consegue retomar a situação sem depender de um painel ainda aberto? |
| Falha entre atualizar e confirmar | Há 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.


