日本語

x402の支払い要件 · 更新日

x402のpayToが
変わったら、
何を比較する?

受取先が変わっていたら注意が必要ですが、変更だけでは、その理由は分かりません。支払いポリシーで対応を決める前に、要件全体、観測時刻、リソースを比較してください。

図解されたエビデンス例を読む

5項目の比較

要件全体から確認する。

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は、クライアントが提示したオプションのうち少なくとも1つが、最近観測されたオプションの和集合に一致しなかったことを意味します。amount_onlyは、提示されたすべてのオプションについて、観測済みのスキーム、ネットワーク、アセット、受取先が一致し、そのうち少なくとも1つの金額が異なったことを意味します。より広いpayee分類は、提示されたオプションのうち少なくとも1つで金額以外のフィールドが一致しなかったことを意味します。受取先だけが変わったと主張するものではありません。

古い観測には別の制限もあります。IFFは新しい要件を最新の観測期間と比較し、matches_last_observedを報告しますが、判定はstaleのままです。条件が最後に保存されたエビデンスと一致するかは分かりますが、古いエビデンスを最新にはできません。

レコードに含まれる情報

履歴から順序を確認し、動機は断定しない。

最新の公開エビデンスカードには、現在保存されている支払いオプションと観測時刻が表示されます。requirements.currentとrequirements.historyのブロックは、連続したフィンガープリントの期間を、初回観測、最終観測、観測回数とともに要約します。公開履歴から、正規化されたオプションセットが変わったことは分かりますが、変更前後を説明する平文や、変更を行った運用者の特定情報は示されません。

  1. 正確なリソースを照合する。パスを含め、同じ正規化済みの公開HTTPSエンドポイントを比較します。
  2. タイムスタンプと鮮度を確認する。古いチャレンジと新しい観測が、異なる正当な状態を示している場合があります。
  3. 提示されたすべてのオプションを比較する。オプションの順序や重複項目は正規化済みセットの差になりません。一方、スキーム、ネットワーク、アセット、受取先、金額は差になります。
  4. 所有権と要件を分けて考える。所有権ディメンションがverifiedであることは、オリジンの管理権限を記録します。支払いアドレスの管理権限は証明せず、observedティアのカードでは所有権が未検証の場合があります。
  5. 自身の保留・エスカレーション規則を適用する。変更が自身のポリシーの基準を超える場合は、別の信頼できる経路でプロバイダーに確認します。

判断するのは自身の支払いポリシー

これらの観測で証明できないこと。

要件の一致は、最近の観測との一貫性を示すエビデンスです。変更された要件は、差があることを示すエビデンスです。どちらの結果も、支払いの安全性、受取先の所有権、承認、不正の確定、サービス提供、決済、支払い後レスポンスの正確性を証明しません。

ライブ検索でエンドポイントを確認 明示的なプリフライト判定を追加 プリフライトAPI仕様を読む