付款
Updated:
每个付费端点均采用 x402 协议相同的两步请求循环:第一个请求返回价格,第二个请求完成支付。
流程
索取报价
POST /orders(或/renew,/traffic,/topup) 不包含付款标题返回
402 Payment Required:正文中的引文以及付款要求在PAYMENT-REQUIRED标题。未预留或收取任何费用。签署授权书
EIP-3009 transferWithAuthorization签署一笔金额为
amounttopayTo通过您的钱包。仅凭签名无法转移资金。请附上签名重复此请求
方法、路径和正文部分保持不变,此外
PAYMENT-SIGNATURE返回
202 Accepted包括操作 ID、其状态,以及针对新订单和充值操作的访问令牌。该PAYMENT-RESPONSE报头承载交易信息。投票结果
GET /orders/{id}或GET /topup/{id}付款首先在网络上得到确认,然后才执行操作。每隔
next_poll_after_seconds直到status_is_terminal是true.
开始之前
在 Base 上持有 USDC 的钱包——即付款方。无需 ETH 支付 gas 费。
x402客户端——任何搭载x402第2版的客户端,即
exactScheme 和 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 说明下一步该做什么(错误)。
付费接口
终点 | 您所支付的服务内容 | 谁可以付款 |
|---|---|---|
| 新任务 | 任意钱包;该钱包将成为订单的所有者 |
| 订单行的更新 | 仅限支付该订单的钱包 |
| 住宅区车流 | 仅限支付该订单的钱包 |
| 自动续费的余额充值 | 任意钱包;该钱包的余额已入账 |
需要多长时间
在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.