Proxy-seller

付款

Updated:

每个付费端点均采用 x402 协议相同的两步请求循环:第一个请求返回价格,第二个请求完成支付。

流程

  1. 索取报价

    POST /orders (或/renew,/traffic,/topup) 不包含付款标题

    返回402 Payment Required:正文中的引文以及付款要求在PAYMENT-REQUIRED 标题。未预留或收取任何费用。

  2. 签署授权书

    EIP-3009 transferWithAuthorization

    签署一笔金额为amount topayTo 通过您的钱包。仅凭签名无法转移资金。

  3. 请附上签名重复此请求

    方法、路径和正文部分保持不变,此外PAYMENT-SIGNATURE

    返回202 Accepted 包括操作 ID、其状态,以及针对新订单和充值操作的访问令牌。该PAYMENT-RESPONSE 报头承载交易信息。

  4. 投票结果

    GET /orders/{id} 或GET /topup/{id}

    付款首先在网络上得到确认,然后才执行操作。每隔next_poll_after_seconds 直到status_is_terminal 是true.

开始之前

  • 在 Base 上持有 USDC 的钱包——即付款方。无需 ETH 支付 gas 费。

  • x402客户端——任何搭载x402第2版的客户端,即exact Scheme 和 EIP-3009,或您自己的代码(付款标题)。

  • 当前术语——来自catalog.terms 进入accept_terms 新订单。

所有付费端点的通用要求

基础网址

https://proxy-seller.com/api/x402/v1

付款流程

x402 第 2 版,规范exact,转账方式 EIP-3009,流程upfront:您需在订单完成前付款。第 1 版标题X-PAYMENT 被拒绝。

引用

一条引文的寿命只有15分钟(quote_expires_at)。付费请求必须重复免费请求的正文内容;仅idempotency_key,callback_url 以及auto_renew 可能会有所不同。

错误模型

真实的 HTTP 状态码以及包含retry_action 说明下一步该做什么(错误)。

付费接口

终点

您所支付的服务内容

谁可以付款

POST /orders

新任务

任意钱包;该钱包将成为订单的所有者

POST /orders/{id}/items/{line_id}/renew

订单行的更新

仅限支付该订单的钱包

POST /orders/{id}/traffic

住宅区车流

仅限支付该订单的钱包

POST /topup

自动续费的余额充值

任意钱包;该钱包的余额已入账

需要多长时间

在202 回复:待付款在Base网络上确认后,订单即视为完成。代理通常在几分钟内即可准备就绪。移动代理由我们的工作人员手动发放:请预留最多3小时。

付费操作绝不会丢失。如果某一步骤失败,系统会自动暂停操作,等待我们的工作人员处理,且不会重复扣款。

付款后

常见问题解答

不需要。已签名的授权文件会由系统自动为您提交至网络。

申请新的报价。如果您已提交带签名的请求,但报价已过期,回复中会告知您应采取的措施:402 quote_expired 回复中直接包含了一段新引文;409 payment_not_settleable 表示您之前的授权仍然有效,因此请等待直至authorization_expires_at 在签署新合同之前。

不。一个授权在网络上只能执行一次,重复执行相同的PAYMENT-SIGNATURE 返回首次尝试的结果。在先前授权仍可执行期间,请勿签署新的授权:错误响应会注明有效期至何时(authorization_expires_at)。

使用相同的请求重复此操作PAYMENT-SIGNATURE。这很安全:您将获得首次尝试的结果。

不通过 API 实现。请联系[email protected] 附订单编号。

如有相关资源,其地址将在目录中公布为protocol.sandbox_url.

On this page

付款 | Proxy-seller