MINARAx402 支付
瞭解並使用 Minara 的單次支付、預授權支付和付費 MCP。
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 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 安裝 MCP 服務。不要把錢包金鑰或支付證明寫入 MCP 設定。MCP 工具可透過 JSON-RPC 返回 x402 挑戰；直連遠端連接也可返回 HTTP 402。JSON-RPC 可用於本機 stdio，HTTP 支付標頭則要求直連遠端連接或由 Broker 原樣轉發。
支援範圍與疑難排解
目前支援 x402 exact 和可信支付資產註冊表中的資產，包括受支援 EVM/Solana 網路上的規範 USDC，以及 X Layer 上的 USD₮0。Minara 會把商戶接受的資產與目前持倉配對，在簽名前重新檢查餘額，並在同等可支付時優先 USDC。不支援 upto、Permit2、aggr_deferred 或任意未註冊代幣。餘額不足時為指定網路充值；挑戰過期時重新請求；支付結果不確定時先查狀態，不要重複付款；證明被拒時不要退化為盲目轉帳。
另請參閱自訂 MCP和Connector 疑難排解。