Skip to Content
入門簡介
View as Markdown

簡介

一筆付款的樣貌

商家整合 InfraIO Pay 時，會接觸到四個核心環節：

結帳 session

你從伺服器端建立 session，帶上商品項目與總額。回應會帶著 session_key（cst_…）與 checkout_url。Session 有時效（預設 30 分鐘）且單次使用。

託管結帳頁

你載入我們的瀏覽器 SDK 並開啟 session — popup、redirect 或內嵌 iframe。買家挑選一個鏈 × 資產組合（例如 Polygon 上的 USDT、Base 上的 ETH……），看到系統產生的每筆訂單獨立收款位址(CREATE2) + QR code，然後從自己的 錢包送出資金。

付款確認

InfraIO Pay 會監看對應的網路，尋找符合該 session 獨立收款位址的 入帳轉帳。一旦達到設定的確認數（例如 Ethereum 主網為 12、Polygon 為 5 — 見支援的鏈與資產），底層的 PaymentIntent 就會轉為 SETTLED，其所屬的 Order 也會轉為 PAID。

TRON、Solana 與 TON 沒有獨立收款位址。買家的錢包直接付款到你的資金庫錢包(TronLink、Solana Pay QR code 或 TON Connect),InfraIO Pay 會辨識這筆付款。請見支援的鏈與資產。

付款會直接進入您的資金庫錢包 — InfraIO Pay 絕不保管您的資金。

Webhook

我們會對你註冊的 webhook URL POST 一個已簽章的 payment.settled 事件。你的伺服器驗證簽章、查詢訂單， 然後履約。

一張圖看懂資料模型

CheckoutSession  ←  1:1  →  Order  ←  1:N  →  PaymentIntent
   (有時效)               (永久)             (每次付款嘗試一筆)

你會為了履約而思考 Order，為了收款而建立 Session，而系統 會在幕後管理 PaymentIntent，處理重試與網路選擇等細節。

我們處理什麼，你處理什麼

InfraIO Pay 處理你處理
託管結帳頁 UI（獨立收款位址、QR code、資產選擇器）你資料庫中的目錄與訂單建立
跨 8 條 EVM 鏈以及 TRON、Solana、TON(即將推出)的鏈上監看 + 確認邏輯Webhook 接收端 + 簽章驗證
多資產穩定幣結帳(各網路的 USDT、USDC)透過 external_ref 對應我們的 order_id ↔ 你的訂單 ID
退款帳務（狀態機、儀表板、API）簽署並廣播鏈上退款交易
測試模式金鑰 + 隔離的測試 webhook從 faucet 為測試網錢包注入資金

我們不託管商家資金。買家到商家的轉帳直接在鏈上發生；我們 是索引 + 對帳層，負責告訴你轉帳何時完成。

測試模式與正式模式

每個帳號一開始都是測試模式。測試金鑰的前綴是 pk_test_ / sk_test_。正式金鑰（pk_live_ / sk_live_）在你完成帳號驗證，並為每個 想接收款項的網路新增資金庫錢包後即可使用（你需要簽署一則訊息， 證明你控制該錢包）。

同一個 API base URL 同時服務兩種環境 — 環境是由金鑰前綴決定， 而非 URL。測試模式跑在真實的測試網上（Sepolia、Base Sepolia、BSC Testnet 等）— 沒有模擬鏈。要觸發一筆測試付款，你 需要從 faucet 取得的真實測試網資金。

聯絡 / 支援

有問題或需要協助？請來信 [email protected]。

InfraIO Pay 不是什麼

  • 不是託管方。 資金由買家直接在鏈上轉入你的資金庫錢包。我們從不 持有你的餘額。
  • 不強制使用錢包。 客戶以 自己的錢包付款（託管結帳頁內建 WalletConnect 選項）。 InfraIO Wallet 是另一款獨立的非託管 passkey 錢包，並非必要。
  • 不是法幣入口。 買家以自己持有的加密資產付款；我們不做 兌換。
  • 不是比特幣的閘道。 支援 8 條 EVM 網路以及 TRON、Solana、TON(即將推出)上的穩定幣;不支援比特幣或 Lightning。完整的支援矩陣請見支援的鏈與資產。

下一步

歡迎快速入門