Há um porém. Quem decide como receber é o endpoint, e os endpoints x402 que um agente encontra costumam pedir USDC em uma rede específica, como Base ou Solana. Seu agente pode ter outra coisa: USDT na Solana, USDC na Stellar ou USDT na BNB Chain. Fazer bridge antes de cada chamada também não funciona, porque um requisito de pagamento x402 só vale por alguns minutos, e mover dinheiro entre redes costuma levar mais tempo que isso.
A ROZO é independente e não é afiliada a nenhum vendedor x402.
Recarregue uma vez, pague muitas vezes
O pagador x402 da ROZO divide o problema em dois. Você recarrega um saldo ROZO uma única vez, com a moeda que já tem, na rede que já usa. Depois disso, cada chamada x402 para um endpoint que aceita USDC na Base é paga com esse saldo em segundos, dentro da janela de pagamento.
Se o seu agente consegue rodar um comando de shell, esta é a integração inteira:
- Recarregue o saldo uma vez. O comando imprime um endereço de depósito de uso único; pague a partir da sua própria carteira: npx @rozoai/checkout x402 topup 20 --with usdt-solana
- Chame um endpoint pago. A CLI lê o 402, a ROZO assina e a requisição é enviada de novo com o pagamento: npx @rozoai/checkout x402 pay https://api.example.com/v1/search --method POST --body '{"q":"..."}'
- Veja o que sobrou: npx @rozoai/checkout x402 balance
O que acontece no x402 pay
Sua máquina envia a requisição direto para o endpoint. Quando o 402 volta, a CLI lê os requisitos de pagamento, mantém apenas a opção de USDC na Base e pede à ROZO que assine esse único pagamento. Em seguida, repete a sua requisição original com o cabeçalho PAYMENT-SIGNATURE e imprime a resposta.
Cada pagamento leva um idempotencyKey, e uma nova tentativa desse pagamento reutiliza a mesma chave, então um timeout não pode cobrar você duas vezes.
Sem shell? O mesmo pagamento funciona com dois endpoints HTTP principais, /v1/x402/topup e /v1/x402/sign, com a sua chave de agente como bearer token. Seu agente repete a própria requisição com a assinatura. A página do x402 mostra as duas chamadas.
O que protege o seu dinheiro
Dar uma carteira a um agente é um risco real, por isso o pagador foi construído com permissões mínimas.
- A chave só gasta o saldo. A primeira recarga cria uma chave de agente que começa com ak_. Ela pode pagar com o seu saldo ROZO e nada mais. Nunca toca a sua própria carteira, a ROZO nunca guarda as chaves da sua carteira e a ROZO armazena apenas um hash da chave de agente.
- Todo pagamento tem um teto. Por padrão, um pagamento individual tem limite de $5 e uma chave pode gastar no máximo $100 por dia. Ambos são padrões e podem ser ajustados por chave. Você também pode restringir uma chave a uma lista de endereços payTo, e a CLI recusa qualquer pagamento individual acima do limite que você define com --max-usd.
- Pagamentos únicos, nunca uma assinatura. Cada chamada precisa de um 402 novo do vendedor e de uma assinatura nova da ROZO. O vendedor nunca recebe uma autorização permanente para cobrar mais depois.
- Sua requisição continua sua. A requisição paga vai da sua máquina para o endpoint. A ROZO nunca vê o corpo da requisição, seus cabeçalhos nem as API keys que você usa nesse serviço. Ela só vê o requisito de pagamento que precisa assinar: quem recebe, quanto e em qual rede.
Com o que você recarrega e o que é pago
São duas pernas, e elas aparecem separadas de propósito.
Perna de recarga, de você para a ROZO:
- USDT na Solana, BNB Chain, Ethereum ou Polygon
- USDC na Solana, BNB Chain, Ethereum, Polygon, Base ou Stellar
Tem uma moeda nativa ou sats? Você pode usá-los para recarregar a OpenRouter com o ROZO Checkout em checkout.rozo.ai.
Perna de pagamento, da ROZO para o vendedor x402:
- Base (eip155:8453): USDC, esquema x402 exact
- Solana: chega mais tarde
Os vendedores sempre recebem em USDC, porque pagamentos x402 exact são transferências de token. O USDT serve apenas para recarregar o saldo; o vendedor recebe em USDC. Se um endpoint aceita apenas USDC na Solana, a CLI para com X402_UNSUPPORTED antes de qualquer cobrança.
A recarga mínima é de $5, e a recarga tem uma taxa de 1%. Cada pagamento x402 com o saldo custa apenas o que o vendedor pede. Saques ainda não são self-service: envie um e-mail para hi@rozo.ai com a sua chave mascarada e o valor, e o saldo é devolvido na rede que você escolher.
Comece agora
O pagador já está no ar. A página checkout.rozo.ai/x402 reúne os três comandos, as chamadas HTTP, os limites e as perguntas frequentes. A referência completa, com todos os códigos de erro, está em docs.rozo.ai. Agentes podem ler as mesmas instruções, com as regras de segurança e as orientações de nova tentativa, em checkout.rozo.ai/llms.txt e no repositório RozoAI/rozo-checkout-skill no GitHub.
Recarregue uma vez com a moeda que você tem e deixe o seu agente pagar sozinho pelas APIs que ele chama.