x402 支付

x402 是基于 HTTP 402 Payment Required 的开放支付协议。服务可以直接声明价格和可接受的链上付款方式，无需先创建账户或复制 API Key。Minara 使用托管钱包支付，并携带与原请求绑定的证明重试。

核心概念

术语	含义
支付要求	服务端声明的收款人、金额、资产、网络、方案和资源。
Exact	固定金额的标准方案。Minara 支持 EVM 和 Solana 上已注册的支付资产；优先选择余额充足的选项，同等可支付时优先 USDC。
支付签名	托管钱包针对一个可信挑战创建的证明，不是可重复使用的 API 凭证。
结算响应	服务或 Facilitator 接受证明后的结果。
预授权	面向某个 Provider、域名或商户的重复付款预算。

Minara 会把挑战绑定到当前用户、原请求、商户、金额、资产、网络和有效期，模型不能替换这些字段。

单次支付

调用 Minara 数据工具、付费 API 或 MCP 工具。
返回 payment_required 后，检查 Provider、资源、资产金额、网络和收款地址。
批准付款。
Minara 创建标准 x402 证明，并只重试一次完全相同的原调用。
查看资源结果以及结算或交易状态。

示例：

获取付费市场报告。如果需要 x402，先展示费用，再单次支付。

标准支付与旧版兼容

标准 x402 v2 exact 使用 EVM EIP-3009/EIP-712 或 Solana 代币转账交易，并通过 PAYMENT-REQUIRED、PAYMENT-SIGNATURE、PAYMENT-RESPONSE 头传递协议数据。

旧服务可能明确要求 transaction-hash proof，并声明接收该证明的 HTTP 头。Minara 只会对标记为 retry_supported 的挑战继续：先核对金额、收款地址、资产和网络，再绑定转账哈希并重试一次。如果服务没有声明安全的证明头，Minara 不会转账，也不会声称可以解锁资源。普通 HTTP 402 不使用该兼容路径。

预授权重复付款

预期发生多次小额扣费时，可设置 Provider 或域名范围、单次上限、USDC 总预算、有效期、商户地址和可选链限制。可通过 /x402 preauth 查看历史或立即撤销。优先使用范围窄、有效期短的预算；新商户、新收款地址、新网络或超额收费不会匹配。

付费自定义 MCP

通过 Connectors → Add connectors → Add MCP server 使用 URL 或受支持的配置添加服务。付费 MCP 使用相同的连接配置，不要把钱包密钥或支付证明写入 MCP 配置。

当 MCP 工具返回有效的 JSON-RPC x402 挑战，或直连远程连接返回 HTTP 402 时，Minara 会展示费用、生成绑定证明并重试相同调用。JSON-RPC 可用于本地 stdio；HTTP 支付头则要求直连远程连接，或由 Broker 原样转发。

支持范围与排错

目前支持 x402 exact 和可信支付资产注册表中的资产，包括受支持 EVM/Solana 网络上的规范 USDC，以及 X Layer 上的 USD₮0。Minara 会把商户接受的资产与当前持仓匹配，在签名前重新检查余额，并在同等可支付时优先 USDC。不支持 upto、Permit2、aggr_deferred 或任意未注册代币。

方案、资产或网络不支持： 选择服务端提供且已注册的 exact 选项。
余额不足： 为选定网络的钱包充值；除非服务端提供其他网络，否则不要自行换链。
挑战过期或变化： 重新请求资源并审核新费用。
支付结果不确定： 先查询状态，不要重复付款。
证明被拒绝： 不要退化为盲目转账，请服务方检查 x402 实现。

另请参阅自定义 MCP和Connector 排错。