# L402: a fatura Lightning e o recibo de acesso, e por que nada disso está no jsonW O L402 cobra um pedido com uma fatura da rede Lightning e entrega um recibo de acesso. O recibo é um token, e não uma senha. Veja os elementos do protocolo, o que um registro precisaria guardar e por que a Wortic ainda não aceita esse meio. 15 de novembro de 2026 · jsonW 1.3.11 · https://jsonw.org/newsroom/l402-recibo-de-acesso-e-fatura-lightning ## O protocolo O L402 é um protocolo para cobrar pedidos de API pela rede Lightning. O nome junta o código HTTP 402 com a rede. Antes, o projeto era conhecido como LSAT. O servidor responde 402 com uma fatura Lightning. Depois de pagar a fatura, o cliente recebe um recibo de acesso. ## Os elementos O protocolo tem três elementos: a fatura, o pagamento e o recibo. A fatura tem um valor e um identificador de pagamento. O recibo é um token criptográfico, que o cliente envia nas chamadas seguintes para provar o acesso. ``` [identificador da fatura, valor em satoshis, prazo de validade, recurso liberado]``` O valor da fatura é pequeno, e geralmente vem em satoshis, a menor unidade do bitcoin. Por isso, o protocolo funciona bem para pedidos de centavos. ## O que um registro precisaria guardar Para cada pedido pago, o registro precisaria de três coisas: o identificador da fatura, o valor e o estado do pagamento. Com isso, a empresa consegue reconciliar o que entrou com o que foi entregue. Esse registro é de dinheiro, e não de descrição. ## Por que nada disso está no jsonW O jsonW da Wortic não tem registro de fatura Lightning, porque a casa não aceita esse meio. O jsonW guarda tarefas do A2A e estados de negociação. Pagamento por fatura seria um caso novo, com outra regra de guarda. ## Por que a Wortic ainda não aceita A Wortic não tem hoje um destino de recebimento para L402. Sem a conta que recebe e sem a rotina que converte e contabiliza, o protocolo ficaria sem onde pousar. ## O que muda para a empresa que aceita A empresa precisa de uma rotina para expirar faturas não pagas. Ela também precisa decidir o que o cliente recebe depois do prazo. Essas regras aparecem no suporte, e não só no código. ## Como conferir Antes de qualquer teste, use a rede de testes do Lightning, e não a rede principal. Confira também a versão da documentação do projeto, porque o formato do token pode mudar entre versões. A documentação está em l402.org, e o código de referência, no GitHub do projeto. ## Campos e tamanhos A fatura é pequena, então o registro pode ser simples: identificador, valor, estado e prazo. O valor em satoshis é um número inteiro. Um número com casas decimais, como um valor em reais, não deve ir para o mesmo campo. ## O que o estado deve dizer O registro pode distinguir três estados: aberta, paga e expirada. Uma fatura expirada não volta a ser paga. Se o cliente pagar depois do prazo, o caso vai para o suporte, e não para uma entrega automática. ## Quem confere o registro A conferência deve somar as faturas pagas e comparar com as entregas feitas. Uma diferença entre as duas listas aponta um pagamento sem entrega ou uma entrega sem pagamento. Essa conferência deve rodar antes do fechamento do mês, e não depois. Fonte: https://www.l402.org/