Sequência de ações
Atualizado:
Compre proxies com uma única solicitação paga — sem conta, sem chave de API.
O fluxo
Verifique o catálogo
GET /catalogPesquise produtos, países, períodos, preços, as finalidades de uso permitidas e os termos vigentes.
Solicite um orçamento
POST /ordersEnvie o pedido sem efetuar o pagamento. Devoluções
402 Payment Requiredcom o preço exato. Não há cobrança alguma.Remuneração
POST /orderscomPAYMENT-SIGNATURERepita a mesma solicitação com o pagamento assinado. Devoluções
202 Accepted, o ID do pedido e o token de acesso.Obter os proxies
GET /orders/{id}Consulte a ordem com o token de acesso até que ela seja
active. A resposta contém os proxies com suas credenciais.
Antes de começar
Carteira com USDC na Base — o suficiente para o pedido. Não é necessário ETH.
Produtos, países e períodos — de Catálogo.
Finalidade de uso e termos — valores de
catalog.intended_useecatalog.terms.
Comum a todos os endpoints de pedidos
URL base
https://proxy-seller.com/api/x402/v1Autenticação
POST /orders é autenticado pelo próprio pagamento. Todos os outros endpoints utilizam o token de acesso do pedido: Authorization: Bearer <access_token>.
Modelo de erros
Códigos de status HTTP reais e um corpo JSON com retry_action (Erros).
Depois de fazer um pedido
Perguntas frequentes
Normalmente, alguns minutos após o 202 Resposta: o pagamento é confirmado primeiro na rede Base; em seguida, os proxies são emitidos. Os proxies para celular são emitidos manualmente por nossa equipe: aguarde até 3 horas. Enquete GET /orders/{id} todos next_poll_after_seconds.
Sim. Um pedido contém um produto e até 20 linhas; cada linha possui seu próprio país (ou pacote MIX), quantidade e prazo.
Não. Faça um pedido separado para cada produto.
Recuperar acesso Lista todos os pedidos da sua carteira com novos tokens de acesso.
O estoque não é reservado antes do pagamento. Se as procurações não puderem ser emitidas a tempo, o pedido exibe delayed: true, e posteriormente provisioning_failed enquanto nossa equipe os emite manualmente. A ordem fica assim: active por si só, assim que os proxies forem emitidos. Você também pode entrar em contato com o suporte para solicitar um reembolso.
Não por meio da API. Entre em contato [email protected] com o número do pedido.
Não. Os pedidos adquiridos por meio do x402 são gerenciados exclusivamente pela API do x402.