Como funciona
Esta página descreve o caminho completo de uma venda, do começo ao fim, em linguagem acessível. Ela é o mapa mental que você deve ter antes de entrar nos detalhes técnicos. Cada etapa aqui tem uma página aprofundada no Guia de Integração.
Os participantes
Seção intitulada “Os participantes”Antes do fluxo, vale conhecer quem está em cena:
- Servidor do jogo (o seu servidor). É a autoridade. Ele conhece os itens, os jogadores e o estoque. É ele quem assina as chamadas e quem entrega o item.
- Client do jogo (a máquina do jogador). É apenas transporte e interface. Ele desenha os botões e leva mensagens do servidor até a Lootfy, mas nunca decide nada sozinho e nunca é fonte de verdade.
- A Lootfy. Registra anúncios, cria transações, cobra o comprador, divide o dinheiro e avisa o seu servidor quando entregar.
- O provedor de pagamento (PSP). Custodia o dinheiro, executa o split e paga os saques.
- Comprador e vendedor. As pessoas. Elas se autenticam no checkout web da Lootfy para pagar e para gerenciar seus recebimentos.
O fluxo de uma venda
Seção intitulada “O fluxo de uma venda”-
O vendedor anuncia um item no jogo. Dentro do seu servidor, o vendedor coloca um item à venda pelo mercado do jogo. No mesmo instante, o seu servidor assina esse anúncio e o registra na Lootfy, informando o item, a quantidade e o preço em reais. A partir daí, aquele anúncio passa a ser um registro da Lootfy.
-
Um comprador decide comprar. Outro jogador escolhe o anúncio e a quantidade que quer. O seu servidor assina uma “oferta de compra” e a Lootfy cria uma transação. Repare que o preço não viaja nessa chamada: a Lootfy já conhece o valor do anúncio e calcula o total.
-
O comprador paga no checkout web. A Lootfy devolve um link de checkout. O comprador abre esse link no navegador, se autentica e paga via Pix. O dinheiro entra no provedor de pagamento, não na Lootfy.
-
A Lootfy avisa o seu servidor para entregar. Assim que o pagamento é confirmado, a Lootfy envia ao seu servidor uma ordem de entrega assinada (um webhook). O seu servidor valida a assinatura e entrega o item ao comprador dentro do jogo.
-
O seu servidor confirma a entrega. Depois de entregar, o seu servidor chama a Lootfy confirmando que o item foi entregue. Essa confirmação é a fonte da verdade da entrega: só depois dela o dinheiro do vendedor fica disponível para saque.
-
O dinheiro é dividido e liberado. O valor pago é dividido entre o vendedor, o seu servidor e a plataforma, conforme as comissões configuradas. Cada parte pode sacar o que é seu quando as condições forem cumpridas.
Por que o dinheiro fica retido
Seção intitulada “Por que o dinheiro fica retido”O ponto que dá segurança ao comprador e ao vendedor é a retenção. Quando o comprador paga, o dinheiro não vai direto para o vendedor. Ele é dividido no provedor de pagamento e fica retido até a entrega ser confirmada pelo seu servidor. Isso garante que ninguém precisa confiar cegamente no outro: o comprador só perde o dinheiro se receber o item, e o vendedor só recebe se entregar.
Onde a criptografia entra
Seção intitulada “Onde a criptografia entra”Todas as chamadas entre o seu servidor e a Lootfy — nos dois sentidos — são assinadas criptograficamente. Isso garante que uma ordem de entrega recebida pelo seu servidor veio mesmo da Lootfy, e que um anúncio recebido pela Lootfy veio mesmo do seu servidor. Como o client do jogo é um ambiente hostil (roda na máquina do jogador), ele nunca assina nada: quem assina é sempre o seu servidor. Esse é o motivo pelo qual existe o Agent.
Antes de começar: o que solicitar à Lootfy
Seção intitulada “Antes de começar: o que solicitar à Lootfy”Uma parte da configuração inicial é feita pela equipe da Lootfy — são operações administrativas da plataforma, e é assim de propósito, porque envolvem credenciais que movem dinheiro. Para dar início à integração do seu servidor, você solicita três coisas:
- O registro do seu servidor na plataforma.
- Uma API key, que identifica o seu servidor nas chamadas.
- Um par de chaves de assinatura (criptografia), que prova que uma chamada veio mesmo de você.
Para pedir, entre no Discord da Lootfy e abra um pedido no canal #integração. Você recebe as credenciais prontas — algumas entregues uma única vez, então guarde-as com cuidado. O restante da configuração (a URL de webhook, a logo, os dados de recebimento) você faz sozinho pela plataforma. O passo a passo está em Provisionamento e credenciais.