繁中

x402 付款要求 · 更新於

x402 的 payTo 位址變更時,該比較什麼?

收款對象不同值得注意,但變更本身不能解釋原因。在你的付款政策決定如何處理前,請比較完整要求、觀測時間與資源。

閱讀圖解證據範例

五部分比較

先檢查完整要求。

payTo 值必須連同網路、資產、金額、方案與資源來看才有意義。保留用戶端實際收到的挑戰及其時間戳記,才能和已儲存的觀測比較,而不是單獨比較一個位址。

合成比較範例說明用數值 · 非即時證據
欄位較早的觀測新的挑戰差異能告訴你什麼
資源/v1/resource/v1/resource這項比較仍針對相同的端點路徑。
網路eip155:8453eip155:8453此範例的付款網路沒有變更。
資產synthetic token 0x…C3synthetic token 0x…C3列出的網路上出現相同的說明用合約識別碼。
金額1000 atomic units1000 atomic units此範例的金額沒有變更。
payTo0x…A10x…B2公布的收款對象不同。證據不會提供變更原因。

所有縮寫位址都是僅供顯示的合成識別碼,不能用作付款指示。

payTo
該付款選項公布的收款對象。出現差異表示用戶端被要求向不同的收款對象值付款。
網路+資產
結算脈絡。相同的位址文字若位於其他網路,或相同代號指向其他資產識別碼,都不是相同的付款選項。
金額
金額是 IFF 完整選項指紋的一部分。如果方案、網路、資產與收款對象相同而只有金額改變,預檢比較可將其分類為 amount_only。
資源
端點 URL 決定 IFF 記錄與比較範圍。不同主機或路徑應視為不同資源檢查。資源不包含在 IFF 的付款選項指紋內。

先理解脈絡再下結論

變更可能是例行作業。

服務提供者可能輪替資金管理位址、遷移託管服務、變更資產或網路、更新價格,或部署新的資源路徑。快取或延遲的挑戰也可能讓有效的轉換短暫看似不一致。這些都是應調查的可能性,不是 IFF 已證實的解釋。

發生衝突時,先暫停並檢查。

diverged 表示用戶端提供的選項中,至少一項與近期觀測選項的聯集不符。amount_only 表示每個提供的選項在方案、網路、資產與收款對象上都與某項觀測相符,但至少一項的金額不同。範圍較廣的 payee 分類表示至少一個提供的選項在非金額欄位中找不到相符項目;它並不聲稱只有收款對象變更。

過期觀測還有另一項限制。IFF 仍會將新要求與最近的觀測時段比較並回報 matches_last_observed,但判定仍為 stale。這能告訴你條件是否符合最後儲存的證據,卻不能讓舊證據成為最新資料。

記錄包含的內容

用歷史記錄確認順序,不推斷動機。

最新的公開證據卡會顯示目前儲存的付款選項與觀測時間。其中 requirements.current 與 requirements.history 區塊會摘要連續的指紋區段,包括首次出現、最後出現與觀測次數。公開歷史記錄能指出正規化後的選項集合發生變更,但不會公開純文字的變更前後說明,也不會把變更歸因於某位操作人員。

  1. 比對正確的資源。比較同一個正規化的公開 HTTPS 端點,包括路徑。
  2. 檢查時間戳記與新鮮度。較舊的挑戰與較新的觀測可能描述不同但都合理的狀態。
  3. 比較所有公布的選項。選項順序與重複項目不會產生不同的正規化集合;方案、網路、資產、收款對象與金額則會。
  4. 分開看待所有權與要求。已驗證的所有權維度記錄來源站控制權。它不證明付款位址的控制權,而 observed 層級的卡片可能仍未驗證所有權。
  5. 套用自己的暫停付款或升級處理規則。變更超過政策門檻時,請透過另一個可信管道向服務提供者確認。

由你的付款政策決定

這些觀測不能證明什麼。

相符的要求是與近期觀測一致的證據;變更的要求是存在差異的證據。兩種結果都不能證明付款安全性、收款對象所有權、授權、已確認的詐欺、服務交付、結算,或付款後回應的正確性。

在即時查詢中檢查端點 加入明確的預檢決策 閱讀預檢 API 規格