Responsabilidades: Lootfy × você
A integração com a Lootfy só funciona quando a fronteira de responsabilidades está clara. Esta página define quem faz o quê. Ela é curta de propósito: leia com atenção, porque quase toda dúvida de integração se resolve voltando aqui.
A regra que rege tudo
Seção intitulada “A regra que rege tudo”A autoridade é sempre o servidor parceiro. O client do jogo é transporte, nunca autor.
O seu servidor é quem conhece a verdade: quem possui qual item, quanto estoque existe, quem tem permissão para vender. Ele assina as chamadas, recebe os webhooks e decide a entrega. O client do jogo, que roda na máquina do jogador, apenas transporta mensagens já assinadas e desenha a interface. Ele nunca pode originar um item, uma quantidade ou um preço, porque a máquina do jogador não é confiável.
Tabela de responsabilidades
Seção intitulada “Tabela de responsabilidades”| Pergunta | Quem responde |
|---|---|
| Quem assina as chamadas? | O seu servidor assina todos os envelopes (JWS RS256). O client só os carrega. A Lootfy assina os webhooks de volta com uma chave própria. |
| Quem guarda o dinheiro? | O provedor de pagamento (PSP). Nunca a Lootfy, nunca você. |
| Quem entrega o item? | O seu servidor, dentro do jogo, ao receber a ordem de entrega assinada. |
| Quem registra o anúncio? | O vendedor dispara no jogo; o seu servidor assina; o client transporta até a Lootfy. |
| Quem cria a transação? | Ela nasce no seu servidor. A Lootfy nunca cria uma transação por conta própria. |
| Quem decide o estoque e quem “ganha” o item? | O seu servidor, no momento da entrega. Ele é o único que enxerga todas as fontes de consumo do item. A estimativa de estoque da Lootfy só recusa, nunca autoriza. |
| Quem valida posse e permissão de venda? | O seu servidor. A Lootfy não conhece as regras internas do seu jogo. |
| Quem verifica banimentos na plataforma? | A Lootfy, na criação do anúncio e no checkout. O seu servidor não conhece os banimentos da plataforma. |
| Quem confirma que a entrega aconteceu? | O seu servidor. Essa confirmação é a fonte da verdade que libera o dinheiro. |
O que a Lootfy assume que o seu servidor consegue fazer
Seção intitulada “O que a Lootfy assume que o seu servidor consegue fazer”A Lootfy não roda o seu jogo, então ela depende de o seu servidor ter algumas capacidades. Elas estão detalhadas em pré-requisitos, mas em resumo o seu servidor precisa conseguir:
- Assinar cada chamada de saída com uma chave privada RSA, sem travar o loop principal do jogo enquanto espera a rede.
- Manter um relógio sincronizado (as assinaturas têm validade curta).
- Expor um endpoint HTTPS que recebe os webhooks da Lootfy, verifica a assinatura e é idempotente.
- Identificar um item de forma estável, com um identificador que sobreviva a um ciclo de save do servidor.
- Entregar um item a um jogador de forma durável, mesmo que ele esteja offline.
O que fica com a Lootfy
Seção intitulada “O que fica com a Lootfy”Do outro lado da fronteira, a Lootfy é responsável por registrar os anúncios, calcular totais, cobrar o comprador via Pix, coordenar a retenção e o split no provedor de pagamento, notificar o seu servidor para entregar, e expor a carteira e os saques. Ela também classifica banimentos de plataforma e faz o gerenciamento de contas, personagens e chaves.