# 支払いリンク — 概要 **支払いリンク** は、あなたが既に設定したホスト型 チェックアウトにバイヤーを誘導する、共有可能な URL です。SDK もサーバー 統合も不要 — ダッシュボードで発行して共有するだけで、資金がオンチェーンで 確定すると同じ `payment.settled` Webhook が発火します。 内部的には、支払いリンクは [CheckoutSession](https://docs.infraio.xyz/ja/concepts/sessions) **そのもの** です — 「支払いリンク」は、バイヤー主導の SDK フローによって 作成されなかったセッションを指す、ダッシュボード側の呼び名にすぎません。 Webhook の契約、オンチェーン決済、手数料はすべて同じです。 主な用途: - コードを書かずに単発の顧客へ請求する - カスタムカートがない販売ページ - B2B のフォローアップ: リンクをメールに貼り付ける - 「コーヒーをおごる」のような固定額のチップページ ## 作成する 支払いリンクはダッシュボードで作成します: 1. [マーチャントダッシュボード](https://app.infraio.xyz) にサインインします 2. **Payments → Payment Links → + New link** 3. 2 つの経路のどちらかを選びます: - **New order** — 行明細、通貨、顧客情報、任意のメタデータを入力します。 ダッシュボードが Order と支払いリンクを 1 回の呼び出しで作成します。 - **Existing order** — `PENDING` の注文を選びます（例: バイヤーが 前回のリンクを放棄した場合）。同じ注文に紐づく新しいリンクを再発行 するので、注文履歴はそのまま維持されます。 - **New order** では **金額のみ** に切り替えると、商品を並べずに金額だけを請求できます。 4. 保存 → ダッシュボードにコピーボタンと QR コードダウンロード付きの `https://checkout.infraio.xyz/cst_…` URL が表示されます。テストモードの リンクは `checkout-dev.infraio.xyz` を使うため、環境がホスト名に エンコードされます。 > **Note:** > > 各支払いリンクは現時点で 1 回限りです。バイヤーが支払うとセッションは > `COMPLETED` になります。決済前にセッションが期限切れになった場合 > （デフォルト TTL は 30 分）は、注文詳細ページを開いて **Re-create > link** をクリックし、同じ注文に対して新しいリンクを発行してください。 ## バイヤーに表示されるもの 1. バイヤーは `checkout.infraio.xyz/` に到着します — SDK から発行されたセッションと同じホスト型チェックアウト UI です。 2. [チェックアウト — 概要](https://docs.infraio.xyz/ja/checkout/overview) で説明されている、 アセット選択 → 資金送金 → 確認待ちという標準フローを進みます。 3. `payment.settled` が Webhook に発火し、注文、インテント、レシート、 オンチェーン tx ハッシュ、確認回数が渡されます — 他の精算済み決済と 同じペイロードです。スキーマは [Webhook](https://docs.infraio.xyz/ja/webhooks/overview) を参照してください。 ## ダッシュボードが提供するもの 支払いリンクの現在の画面には以下が含まれます: - **一覧表示** — これまでに発行したすべてのリンクをカーソルページネーション で表示し、ステータス、金額、親注文番号、顧客、有効期限、バイヤー URL へのワンクリックオープンが確認できます。 - **フィルタ** — ステータス（`ACTIVE` / `COMPLETED` / `EXPIRED` / `CANCELED`）、日付範囲、注文番号・顧客名・メール・外部参照を横断する 全文検索。 - **CSV エクスポート** — ワンクリックで、現在のフィルタを反映します。 - **KPI ストリップ** — ステータスごとの件数を現在の環境（`live` または `test`）について表示し、テーブルの内容と一致します。 - **詳細ページ** — 注文サマリー、セッション履歴（この注文に対する すべての試行）、ブロックエクスプローラーへのリンク付きオンチェーン履歴、 決済前に期限切れになったセッション向けの **Re-create link** アクション。 ## 現時点での制限事項 - **プログラムによる API はありません** — リンクはダッシュボードでのみ 作成できます。`POST /b2b/v1/checkout-sessions/quick` （[API リファレンス](https://docs.infraio.xyz/ja/api-reference) を参照）で同等の 1 回限り セッションを作成できますが、共有可能なリンクはダッシュボードでのみ 作成します。 - **バイヤー単位の認証はありません** — URL を持つ人なら誰でも支払え ます。各リンクは 1 回限りのため、ある程度これを緩和できます。 - **ブランディングはグローバルです** — リンクは **Settings → Branding** のマーチャント全体のロゴ、ブランドカラー、境界の丸みを 使用します。リンク単位のブランディング上書きは利用できません。 ## 関連ページ - [コンセプト → セッション](https://docs.infraio.xyz/ja/concepts/sessions) — バイヤーが決済中、 セッション層とインテント層で何が起きているか。 - [チェックアウト → 概要](https://docs.infraio.xyz/ja/checkout/overview) — バイヤーが実際に 目にするもの。 - [Webhook → 概要](https://docs.infraio.xyz/ja/webhooks/overview) — あなたのサーバーが反応する `payment.settled` イベント。