Checkout e pagamento

O checkout é a única parte do fluxo em que uma pessoa age diretamente com a plataforma. Quando o seu servidor cria uma transação, a resposta traz uma checkoutUrl. O seu papel é entregar essa URL ao comprador dentro do jogo; o resto do pagamento acontece na web, na Lootfy — você não constrói essa tela nem faz chamadas de checkout. Esta página existe para você entender o que se passa nela, porque é o que leva a transação a PAGO, e é o PAGO que dispara a sua ordem de entrega.

Para o dono de servidor: depois que o seu servidor devolve a checkoutUrl, o pagamento é entre a Lootfy e o comprador. O dinheiro entra no provedor de pagamento, é dividido e fica retido — e só então a Lootfy avisa o seu servidor para entregar.

O que acontece na tela da Lootfy

1. O comprador abre a checkoutUrl. Ela é endereçada por um handle opaco. O comprador precisa estar autenticado na conta dona do personagem receptor — se chegar deslogado, o checkout guarda o endereço, pede login e volta.

2. Ele confere o que está comprando. A tela mostra o servidor, o personagem receptor, o item, a quantidade e o valor total. A descrição do item é exatamente o texto que o seu servidor enviou no campo attributes do anúncio.

3. Ele paga o Pix. A Lootfy emite uma cobrança Pix real, com o split de três destinos já embutido. O comprador paga pelo próprio banco.

4. O pagamento é confirmado. O provedor de pagamento confirma o Pix, o dinheiro é dividido e fica retido. É neste instante que a transação vai a PAGO.

O texto de attributes é a promessa da venda

O que aparece para o comprador como descrição do item é a string que o seu servidor montou em attributes ao registrar o anúncio. É a única descrição do item antes de pagar, e a prova do que foi prometido em caso de disputa. Monte esse texto com cuidado — a tela o exibe como está, sem interpretar.

Os seus dois pontos de contato

Você não lê nem chama o checkout, mas ele se conecta ao seu lado por duas pontas que são suas:

• De saída: a checkoutUrl que você recebe ao criar a transação e entrega ao jogador.
• De entrada: quando o pagamento é confirmado, a plataforma dispara para o seu servidor o webhook transfer_order (a ordem de entrega). Se precisar consultar o estado a qualquer momento, use GET /v1/api/transactions/{transactionId} — é a rota de parceiro para acompanhar a transação. Não há webhook nem notificação de checkout para o seu servidor além do transfer_order.

O prazo do pedido

A transação tem um prazo (por padrão, 30 minutos) contado da criação. Passado esse tempo sem pagamento, ela deixa de ser pagável. Se o comprador deixar vencer, o fluxo recomeça: o seu servidor cria uma nova transação, gerando uma nova checkoutUrl.

Próximo: webhook e entrega Pagamento confirmado dispara a ordem de transferência — como validá-la, entregar e confirmar.