Pagamentos
Atualizado:
Cada endpoint pago utiliza o mesmo ciclo de duas solicitações do protocolo x402: a primeira solicitação retorna o preço, e a segunda efetua o pagamento.
O fluxo
Solicite um orçamento
POST /orders(ou/renew,/traffic,/topup) sem cabeçalhos de pagamentoRetornos
402 Payment Required: a cotação no corpo do texto e os requisitos de pagamento noPAYMENT-REQUIREDcabeçalho. Nada é reservado nem cobrado.Assine a autorização
EIP-3009 transferWithAuthorizationAssine uma transferência de USDC no valor exato de
amountparapayTocom sua carteira. Uma assinatura por si só não transfere fundos.Repita a solicitação com a assinatura
O mesmo método, caminho e corpo, além de
PAYMENT-SIGNATURERetornos
202 Acceptedcom o ID da operação, seu status e, para novos pedidos e recargas, um token de acesso. OPAYMENT-RESPONSEO cabeçalho transporta a transação.Votar no resultado
GET /orders/{id}ouGET /topup/{id}O pagamento é confirmado primeiro na rede e, em seguida, a operação é concluída. Verifique a cada
next_poll_after_secondsatéstatus_is_terminalétrue.
Antes de começar
Carteira com USDC na Base — o pagador. Não é necessário ETH para pagar o gás.
Cliente x402 — qualquer cliente com a versão 2 do x402, o
exactscheme e EIP-3009, ou seu próprio código (Cabeçalhos de pagamento).Termos atuais — as versões de
catalog.termsacesseaccept_termsde uma nova ordem.
Comum a todos os endpoints pagos
URL base
https://proxy-seller.com/api/x402/v1Protocolo de pagamento
x402 versão 2, esquema exact, método de transferência EIP-3009, fluxo upfront: você paga antes que o pedido seja atendido. O cabeçalho da versão 1 X-PAYMENT foi rejeitado.
Citação
Uma citação dura 15 minutos (quote_expires_at). A solicitação paga deve repetir o corpo da solicitação não paga; apenas idempotency_key, callback_url e auto_renew podem variar.
Modelo de erros
Códigos de status HTTP reais e um corpo JSON com retry_action que explica o que fazer a seguir (Erros).
Endpoints pagos
Endpoint | O que você paga | Quem pode pagar |
|---|---|---|
| Uma nova ordem | Qualquer carteira; ela se torna a proprietária do pedido |
| Renovação de uma linha de pedido | Apenas a carteira que pagou o pedido |
| Tráfego residencial | Apenas a carteira que pagou o pedido |
| Recarga de saldo para renovação automática | Qualquer carteira; o saldo dessa carteira é creditado |
Quanto tempo leva
Após o 202 Assim que o pagamento for confirmado na rede Base, o pedido será atendido. Os proxies geralmente ficam prontos em poucos minutos. Os proxies para celular são emitidos manualmente por nossa equipe: aguarde até 3 horas.
Uma operação paga nunca é perdida. Se uma etapa falhar, a operação fica em espera até que nossa equipe intervenha, e o valor não é cobrado duas vezes.
Depois de efetuar o pagamento
Perguntas frequentes
Não. A autorização assinada é enviada à rede para você.
Solicite um novo orçamento. Se você já enviou uma solicitação assinada com um orçamento vencido, a resposta informará o que fazer: 402 quote_expired vem com uma nova citação diretamente na resposta; 409 payment_not_settleable significa que sua autorização anterior ainda pode ser executada; portanto, aguarde até que authorization_expires_at antes de assinar um novo.
Não. Uma autorização só pode ser executada na rede uma única vez, e repetir a mesma PAYMENT-SIGNATURE retorna o resultado da primeira tentativa. Não assine uma nova autorização enquanto a anterior ainda puder ser executada: as respostas de erro indicam até quando (authorization_expires_at).
Repita a mesma solicitação com o mesmo PAYMENT-SIGNATURE. É seguro: você obtém o resultado da primeira tentativa.
Não por meio da API. Entre em contato [email protected] com o número do pedido.
Caso haja um disponível, seu endereço é publicado no catálogo como protocol.sandbox_url.