Pular para o conteúdo
jsonW Paper GitHub

Protocolos de comércio com agentes

MPP: a sessão de pagamento, o recibo no cabeçalho e o que isso exige do registro

O MPP acumula cobranças pequenas numa sessão e devolve um recibo no cabeçalho de cada pagamento. Esse modelo exige um registro que feche a sessão corretamente. Veja os elementos do rascunho da IETF, o que um registro precisaria guardar e o estado do protocolo na Wortic.

· jsonW 1.3.11

O protocolo

O MPP (Machine Payments Protocol) é um protocolo para pagamentos entre máquinas, proposto pela Stripe e pela Tempo. Ele usa o código HTTP 402 e um esquema de autenticação chamado Payment. O rascunho está no datatracker da IETF, como rascunho individual.

O protocolo tem dois modos principais: a cobrança avulsa, uma por pedido, e a sessão, em que as cobranças são somadas e acertadas depois.

O recibo

Quando o pagamento é aceito, o servidor devolve um recibo no cabeçalho Payment-Receipt. O recibo prova que o pagamento existe.

Payment-Receipt: [prova do pagamento aceito]

O que a sessão exige do registro

A sessão é o ponto de maior risco. Ela soma cobranças pequenas, e o acerto final pode diferir do que foi usado. Por isso, o registro precisa guardar cada cobrança parcial, o saldo aberto e o momento do fechamento.

Sem esses três dados, a empresa não consegue explicar a conta do cliente. Esse registro é de dinheiro, e precisa de conferência própria.

Onde isso ficaria na Wortic

O jsonW da casa não guarda hoje nenhuma sessão de pagamento. As tarefas do A2A e os estados de negociação ficam no jsonW, mas são outra coisa. Uma sessão de MPP precisaria de um registro próprio, com regras de fechamento.

O estado do protocolo na Wortic

A Wortic não aceita MPP. Não há destino de recebimento para esse meio. As APIs seguem com limite de pedidos.

Cuidados com o rascunho

O MPP é um rascunho individual na IETF. Ele pode mudar antes de virar norma, e pode não virar. Confira sempre a versão mais recente antes de codificar. Um rascunho na mesma área, sobre agentes e pagamentos, trata de um controle diferente, o de bloquear ações do agente até a aprovação de uma pessoa.

Como conferir

Leia o rascunho na página oficial e confira o cabeçalho de recibo com um exemplo de teste. Não use chave de produção. Se a sessão for usada, teste também o fechamento com saldo zero e com saldo aberto.

O rascunho oficial está em datatracker.ietf.org.

O que é gravado a cada cobrança

Numa sessão, cada cobrança parcial deve virar uma linha com o identificador da sessão, o valor, o instante e o saldo depois da cobrança. Assim, o saldo sai da soma das linhas, e não de uma conta feita de cabeça.

Fechamento

No fechamento, o registro grava uma linha final com o valor acertado e o motivo. O motivo pode ser o limite atingido, o tempo esgotado ou o cancelamento do cliente. Quem auditar a sessão lê a sequência inteira do identificador.

Formato do recibo

O recibo chega no cabeçalho Payment-Receipt. O registro da casa deve guardar esse mesmo texto, para conferir depois sem depender do cliente.

Rascunho do MPP na IETF (draft-httpauth-payment) →