Conceitos

Pagamentos e a folha de pagamento

Copiar página

Pessoas pagam pelo que seu app vende em $LIA, em Lia's própria folha de pagamento, ao preço nos registros de Lia. Seu servidor confirma cada cobrança, entrega-a ou a reembolsa.

#Como um pagamento funciona

Sua página perguntaLia.pay("extra-lives") com o id de um dos seus produtos.
a planilha de pagamento Lia abre sobre seu appEle exibe o item e seu preço das anotações de Lia (nunca do seu site), seu app e o nome do desenvolvedor, e o saldo da pessoa após.
A pessoa confirmaO $LIA deixa seu saldo. Lia Labs mantém sua parte para você, e a cobrança é registrada para seu app como paid.
Sua página ouve issopay() respostas { chargeId, productId }. A charge.paid o webhook também vai para o seu servidor.
Seu servidor entregaEle verifica a cobrança com Lia, dá ao pessoa o que ela comprou e marca a cobrança delivered. Ou, se não puder, reembolsa.

Sua página nunca lida com dinheiro, cartões ou carteiras e pode'não mude o preço: a planilha mostra apenas o que'em Lia's registros.

#Produtos

O que seu app vende é configurado pela equipe Lia (até que o portal de desenvolvedores chegue). Cada produto tem:

Campo	Regras
`id`	1 a 64 caracteres: letras, dígitos, `_`, `.` e `-`, começando com uma letra ou dígito. Este é o que você passa para `Lia.pay()`.
`name`	Até 60 caracteres, mostrados na folha de pagamento e na pessoa's atividade.
`price`	Em $LIA, mais de 0 e até 1,000,000, para 6 casas decimais.
`active`	Remover um produto apenas o esconde: seus pagamentos anteriores permanecem.

Seu servidor pode listá-los com GET /products.

#Cobranças

Uma cobrança é um pagamento. Ele tem um id como ch_9b1f… e um status:

Status	Significado
`paid`	A pessoa pagou. Seu aplicativo não'não entregou ainda.
`delivered`	Seu servidor disse que o entregou. Entregar novamente não muda nada.
`refunded`	O $LIA voltou para a pessoa. Uma cobrança reembolsada pode'não seja entregue.

Seu servidor trabalha com cobranças através de GET /charges/:id, POST /charges/:id/deliver e POST /charges/:id/refund.

Quando uma cobrança ativa é paga, o preço total sai da pessoa's saldo. Sua parte (70% a menos que acordado com a equipe Lia) é mantida por Lia Labs para você, e o restante fica com Lia. Um reembolso devolve ao pessoa o preço total, de ambos.

Lia Labs paga sua parte mensalmente, em seu próprio saldo Lia. A partir da mainnet $LIA no Q1 2028, você pode retirá-lo para sua carteira. Veja Receber pagamento.

#Nunca perca um pagamento

Uma página pode recarregar, travar ou perder a conexão entre a folha de pagamento e o seu servidor. Lia mantém cada cobrança paga até que o seu servidor a entregue, e dá à sua página três formas de encontrá-las:

pay() respostas com { chargeId, productId } no caso normal.
Lia.onCharge(fn) ouviu uma cobrança que foi confirmada enquanto não pay() estava esperando, por exemplo, após a página ter sido recarregada enquanto a planilha estava aberta.
Lia.charges() lista este jogador'suas taxas pagas, não entregues (mais antigas primeiro, até 50). Chame-a quando seu app abrir.

E seu servidor pode confiar no charge.paid webhook em vez da página. Vender um item reúne todos esses elementos.

#Quando um pagamento não acontece'ocorrer

Lia.pay() falha com um erro cujo code diz por quê:

Código	Quando
`cancelled`	A pessoa fechou a folha sem pagar. O mais comum: trate como um normal "não".
`no_product`	Aí's não tem produto ativo com esse id para seu app.
`busy`	Outro de Lia'telas já estão abertas sobre seu aplicativo.
`bad_productId`	O id não'para texto até 64 caracteres.

Se a pessoa não'não tiverem $LIA suficiente, ou o pagamento falhar no caminho, a planilha de pagamento informa isso automaticamente e permanece aberta para que eles tentem novamente. Sua página só ouve cancelled quando eles fecham.

#Modo de teste

No modo de teste, a folha de pagamento diz isso, ninguém's saldo se move, e ninguém precisa de $LIA suficiente. Tudo o mais (seu servidor'chamadas, webhooks, entrega e reembolso) funciona como em produção. Veja Teste e live.

#A folha de pagamento em Lia

A captura de tela abaixo é uma captura completa de Lia em Android, mostrando a confirmação de pagamento para Lia Chess. Sua página pede para pagar; a pessoa confirma na própria folha de Lia.

Confirmação de pagamento da Lia no Android

Traduzido automaticamente. O inglês é a fonte de verdade. Leia em inglês