Protocolos de comércio com agentes
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.
· jsonW 1.3.11
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.