Skip to Content
支払いリンク概要
View as Markdown

支払いリンク — 概要

支払いリンク は、あなたが既に設定したホスト型 チェックアウトにバイヤーを誘導する、共有可能な URL です。SDK もサーバー 統合も不要 — ダッシュボードで発行して共有するだけで、資金がオンチェーンで 確定すると同じ payment.settled Webhook が発火します。

内部的には、支払いリンクは CheckoutSession そのもの です — 「支払いリンク」は、バイヤー主導の SDK フローによって 作成されなかったセッションを指す、ダッシュボード側の呼び名にすぎません。 Webhook の契約、オンチェーン決済、手数料はすべて同じです。

主な用途:

  • コードを書かずに単発の顧客へ請求する
  • カスタムカートがない販売ページ
  • B2B のフォローアップ: リンクをメールに貼り付ける
  • 「コーヒーをおごる」のような固定額のチップページ

作成する

支払いリンクはダッシュボードで作成します:

  1. マーチャントダッシュボード  にサインインします
  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 を使うため、環境がホスト名に エンコードされます。

各支払いリンクは現時点で 1 回限りです。バイヤーが支払うとセッションは COMPLETED になります。決済前にセッションが期限切れになった場合 （デフォルト TTL は 30 分）は、注文詳細ページを開いて Re-create link をクリックし、同じ注文に対して新しいリンクを発行してください。

バイヤーに表示されるもの

  1. バイヤーは checkout.infraio.xyz/<session_key> に到着します — SDK から発行されたセッションと同じホスト型チェックアウト UI です。
  2. チェックアウト — 概要 で説明されている、 アセット選択 → 資金送金 → 確認待ちという標準フローを進みます。
  3. payment.settled が Webhook に発火し、注文、インテント、レシート、 オンチェーン tx ハッシュ、確認回数が渡されます — 他の精算済み決済と 同じペイロードです。スキーマは Webhook を参照してください。

ダッシュボードが提供するもの

支払いリンクの現在の画面には以下が含まれます:

  • 一覧表示 — これまでに発行したすべてのリンクをカーソルページネーション で表示し、ステータス、金額、親注文番号、顧客、有効期限、バイヤー URL へのワンクリックオープンが確認できます。
  • フィルタ — ステータス（ACTIVE / COMPLETED / EXPIRED / CANCELED）、日付範囲、注文番号・顧客名・メール・外部参照を横断する 全文検索。
  • CSV エクスポート — ワンクリックで、現在のフィルタを反映します。
  • KPI ストリップ — ステータスごとの件数を現在の環境（live または test）について表示し、テーブルの内容と一致します。
  • 詳細ページ — 注文サマリー、セッション履歴（この注文に対する すべての試行）、ブロックエクスプローラーへのリンク付きオンチェーン履歴、 決済前に期限切れになったセッション向けの Re-create link アクション。

現時点での制限事項

  • プログラムによる API はありません — リンクはダッシュボードでのみ 作成できます。POST /b2b/v1/checkout-sessions/quick （API リファレンス を参照）で同等の 1 回限り セッションを作成できますが、共有可能なリンクはダッシュボードでのみ 作成します。
  • バイヤー単位の認証はありません — URL を持つ人なら誰でも支払え ます。各リンクは 1 回限りのため、ある程度これを緩和できます。
  • ブランディングはグローバルです — リンクは Settings → Branding のマーチャント全体のロゴ、ブランドカラー、境界の丸みを 使用します。リンク単位のブランディング上書きは利用できません。

関連ページ

概要Shopify