<!-- Source: https://docs.infraio.xyz/ja/get-started/introduction -->
<!-- Last updated: 2026-10-04 -->

# はじめに

## 決済の全体像

InfraIO Pay を組み込むマーチャントが扱う要素は 4 つあります。

### チェックアウトセッション

サーバー側で行明細と合計金額を指定してセッションを作成します。
レスポンスには `session_key`（`cst_…`）と `checkout_url` が含まれます。
セッションは時間制限付き（デフォルト 30 分）で 1 回限りです。

### ホスト型チェックアウトページ

ブラウザ SDK を読み込み、セッションを開きます — popup、redirect、
または埋め込み iframe です。バイヤーはチェーン × アセットの組み合わせ
（Polygon 上の USDT、Base 上の ETH、…）を選び、生成されたデポジット
アドレス + QR コードを確認し、自分のウォレットから資金を送ります。

### 決済確認

InfraIO Pay は該当ネットワークを監視し、セッションのデポジット
アドレスに一致する着金を追跡します。設定された確認回数（例:
Ethereum メインネットで 12、Polygon で 5 — [チェーン & アセット](https://docs.infraio.xyz/ja/concepts/chains)
を参照）をクリアすると、背後の PaymentIntent は `SETTLED` に、
親の Order は `PAID` に遷移します。

TRON、Solana、TON には入金先アドレスがありません。購入者のウォレットがマーチャントのトレジャリーウォレットへ直接支払い（TronLink、Solana Pay の QR、または TON Connect）、InfraIO Pay がその支払いを認識します。[チェーン & アセット](https://docs.infraio.xyz/ja/concepts/chains) を参照してください。

> お支払いはお客様のトレジャリーウォレットに直接入金されます。InfraIO Payが資金を預かることはありません。

### Webhook

登録された Webhook URL に、署名付きの `payment.settled` イベントを
POST します。あなたのサーバーは署名を検証し、注文を照会して、
フルフィルメントを行います。

## 1 枚の図で見るデータモデル

```
CheckoutSession  ←  1:1  →  Order  ←  1:N  →  PaymentIntent
   (時間制限付き)              (永続)            (支払い試行ごとに 1 つ)
```

フルフィルメントについては **Order** を参照し、決済を受け取る
ときは **Session** を作成します。リトライやネットワーク選択については、
システムが背後で **PaymentIntent** を管理します。

## 当方が対応すること vs. あなたが対応すること

| InfraIO Pay が対応すること | あなたが対応すること |
| --- | --- |
| ホスト型チェックアウト UI（入金先アドレス、QR、アセット選択） | 自社 DB でのカタログ + 注文の作成 |
| 8 つの EVM チェーンと TRON、Solana、TON（近日公開）にわたるチェーン監視 + 確認ロジック | Webhook の受信 + 署名検証 |
| マルチアセットのステーブルコインチェックアウト（ネットワークごとの USDT、USDC） | `order_id` と自社の注文 ID を `external_ref` で紐付け |
| 返金会計（ステートマシン、ダッシュボード、API） | オンチェーン返金トランザクションの署名 + ブロードキャスト |
| テストモードキー + 分離されたテスト Webhook | フォーセットからのテストネットウォレットへの資金供給 |

> **Note:**
>
> 当方はマーチャント資金の管理を保持しません。バイヤーからマーチャントへの
> 送金は **直接** オンチェーンで行われます。当方はインデクサー兼
> リコンサイル層として、送金が確定したタイミングを通知します。

## テストモード vs ライブモード

すべてのアカウントは **テストモード** で開始します。テストキーには
`pk_test_` / `sk_test_` のプレフィックスが付きます。ライブキー
（`pk_live_` / `sk_live_`）は、アカウント認証を完了し、受け取りたい
各ネットワークのトレジャリーウォレットを追加すると利用できます（ウォレットを
管理していることを証明するメッセージに署名します）。

同じ API ベース URL が両方に対応します — 環境は URL ではなく
**キーのプレフィックス** で決まります。テストモードは **実際の
テストネット**（Sepolia、Base Sepolia、BSC Testnet など）に対して
動作します — モックチェーンはありません。テスト決済をトリガーする
には、フォーセットから実際のテストネット資金を取得する必要があります。

## お問い合わせ・サポート

ご質問やサポートが必要な場合は、[contact@lartech.xyz](mailto:contact@lartech.xyz) までメールでご連絡ください。

## InfraIO Pay ではないもの

- **カストディアンではありません。** 資金はバイヤーからあなたの受取
  ウォレットへオンチェーンで直接移動します。当方があなたの残高を保持する
  ことはありません。
- **ウォレットは必須ではありません。** 顧客は自分のウォレットから
  支払います（ホスト型チェックアウトには組み込みの WalletConnect オプションが
  あります）。[InfraIO Wallet](https://docs.infraio.xyz/ja/wallet/overview) は独立したノンカストディアルの
  パスキーウォレットであり、利用は必須ではありません。
- **フィアットランプではありません。** バイヤーは保有している暗号資産で
  支払います。当方は変換を行いません。
- **Bitcoin ゲートウェイではありません。** 8 つの EVM ネットワークと TRON、Solana、TON（近日公開）上のステーブルコインに対応しており、Bitcoin や Lightning は対象外です。最新の対応マトリクスは [チェーン & アセット](https://docs.infraio.xyz/ja/concepts/chains) を参照してください。

## 次に

- [クイックスタート](https://docs.infraio.xyz/ja/get-started/quickstart) — 約 10 分で
  コピー&ペーストの初回インテグレーションを完了させます。
- [コンセプト → セッション](https://docs.infraio.xyz/ja/concepts/sessions) — データモデルを
  詳しく解説します。
- [SDK → JavaScript](https://docs.infraio.xyz/ja/sdks/javascript) — 現在公開している唯一の
  SDK です。
- [料金と手数料](https://docs.infraio.xyz/ja/concepts/pricing) — ボリュームティアと割引。
- [マーチャントアプリ](https://docs.infraio.xyz/ja/get-started/merchant-app) — スマートフォンからビジネスを管理できます。