お支払い
Updated:
すべての有料エンドポイントは、x402プロトコルの同じ2リクエストサイクルを使用します。1つ目のリクエストで価格が返され、2つ目のリクエストで支払いが行われます。
流れ
お見積りをご依頼ください
POST /orders(または/renew,/traffic,/topup) 支払いに関する見出しは含めない戻り値
402 Payment Required:本文中の引用文および支払条件については、PAYMENT-REQUIREDヘッダー。予約や課金はありません。承認に署名してください
EIP-3009 transferWithAuthorizationUSDCの送金には、正確に
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は必要ありません。
x402クライアント — x402バージョン2を搭載したすべてのクライアント、すなわち
exactSchemeおよびEIP-3009、あるいは独自のコード(支払いの見出し)。現在の用語 — 以下のバージョンからの
catalog.terms詳細はこちらaccept_terms新しい注文について。
すべての有料エンドポイントに共通する事項
ベースURL
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ステータスコードと、JSON形式の本文をretry_action 次に何をすべきかを示す(誤り)。
有料エンドポイント
エンドポイント | 料金の内訳 | 支払い可能な対象者 |
|---|---|---|
| 新しい注文 | 任意のウォレット。そのウォレットが注文の所有者となります。 |
| 注文行の更新 | 注文の支払いに使用されたウォレットのみ |
| 一般ユーザーによるアクセス | 注文の支払いに使用されたウォレットのみ |
| 自動更新のための残高補充 | 任意のウォレット。このウォレットの残高が加算されます。 |
所要時間
その後、202 回答:Baseネットワーク上で支払いが確認され次第、注文は完了となります。プロキシは通常、数分以内に準備が整います。モバイルプロキシは弊社スタッフによる手動発行となるため、最大3時間ほどお時間をいただく場合があります。
有料の操作は決して無駄になることはありません。手順のいずれかが失敗した場合、操作は担当スタッフが対応するまで待機し、料金が二重に請求されることはありません。
お支払い完了後
よくある質問(FAQ)
いいえ。署名済みの承認書は、あなたに代わってネットワークに提出されます。
新しい見積もりを依頼してください。有効期限が切れた見積もりが添付された署名済みの依頼をすでに送信している場合は、返信に今後の対応方法が記載されています:402 quote_expired レスポンス内に新しい引用文が直接含まれています;409 payment_not_settleable は、以前の認証がまだ有効であることを意味するため、authorization_expires_at 新しい契約に署名する前に。
いいえ。1つの認証はネットワーク上で1回のみ実行可能であり、同じものを繰り返しPAYMENT-SIGNATURE は最初の試行の結果を返します。以前の認証がまだ実行可能な間は、新しい認証を行わないでください。エラー応答には、有効期限がいつまでかが記載されています(authorization_expires_at)。
同じリクエストを同じPAYMENT-SIGNATURE。これで問題ありません。最初の試行の結果が反映されます。
API経由ではありません。お問い合わせください。[email protected] 注文IDを添えて。
利用可能な場合は、そのアドレスはカタログに以下のように掲載されます。protocol.sandbox_url.