> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 支払いリンク（ノーコードでの集金）

> 何も連携せずに Merchant Portal から支払いを受け取る方法：支払いリンクとは何か、作成時に入力するフィールド、有効期限の仕組み、1 つのリンクがちょうど 1 件の注文になる理由、結果の追跡場所、代わりに Checkout を使うべき場面を説明します。

**支払いリンク**は、Merchant Portal で作成して顧客に送るチェックアウト URL です。貴社側で何も連携する必要はありません。Waffo が注文を作成し、決済ページをホストし、結果を Portal に表示します。

**Transactions → Payment Link** から利用できます。リンクの作成は権限で制御されており、その権限を持たないユーザーには **New Payment Link** ボタンが無効表示されます。ページを開けてボタンが有効であれば、この機能は貴社アカウントで有効になっています。

## 連携ではなく支払いリンクを使うべきなのはどんなときですか？

| 状況 | 使うもの |
| - | - |
| Web サイトやアプリがない、または販売がチャット・メール・電話で行われる | **支払いリンク** |
| 単発の集金：Invoice、手付金、手動の再請求 | **支払いリンク** |
| 自社サイトやアプリ内のチェックアウトフロー | [Checkout](/docs/ja/developer-docs/integration/checkout/steps) |
| 大量処理、自社の注文 ID、Webhook、自社システムからの返金実行 | [API 連携](/docs/ja/developer-docs/integration/api/overview) |
| 継続課金 | サブスクリプション — 支払いリンクでは作成できません |

両者は 2 つの別プロダクトではなく同じ仕組みです。支払いリンクは API 注文と同じ注文作成パスを通じて作成され、コピーする URL は API 連携で `orderAction.webUrl` が返すのと同じホスト型決済ページです。異なるのは誰が注文を作成するか、Portal か貴社のサーバーか、という点だけです。

## リンクを作成するとき何を入力しますか？

| フィールド | 必須 | 備考 |
| - | - | - |
| **Portal User Terminal** | はい | `Web` または `App` — 支払者がリンクを開く場所。提供できる決済手段と生成されるリンクの種類に影響します。 |
| **Order Description** | はい | 自由記述。確認ダイアログと一覧の最初の列に表示されるため、識別しやすいものにしてください。 |
| **Product** | はい | `ONE_TIME_PAYMENT` または `DIRECT_PAYMENT`。受け付けるのはこの 2 つだけで、それ以外は拒否されます。 |
| **Country** | はい | 支払者の国。ページに表示される決済手段を決めます。 |
| **Acquiring Currency** | はい | 注文通貨 — 集金する通貨です。 |
| **User Currency** | いいえ | 集金通貨と異なる場合に、支払者が課金される通貨。同一通貨での集金では空のままにしてください。 |
| **Price** | はい | ゼロより大きい必要があります。リンク作成後は固定されます。 |
| **Email** | いいえ | 有効なアドレスである必要があります。注文上の支払者識別子として保存されます。空のままにするとプレースホルダーの識別情報が生成されるため、実在の顧客まで注文を追跡したい場合は必ず入力してください。 |
| **Order Expired At** | いいえ | 下記を参照。過去の日付は選択できません。 |

**Product** は貴社の Payin 契約で有効なものである必要があります。Portal の **Service → Payin** を確認してください。契約にないプロダクトは、`/api/v1/order/create` の場合と同様に検証で失敗します。

送信すると、説明、金額と通貨、国、そしてコピーボタン付きのリンク自体を含む確認ダイアログが表示されます。そこでコピーして共有してください。リンクが渡されるのはこの瞬間です。

## リンクの有効期限はどのように機能しますか？

* **Order Expired At を空のままにする**と、貴社アカウントに設定されたデフォルトの注文有効期限が適用されます。Portal では **Order Expired At** 列のツールチップにそのデフォルトが表示されます。
* **日時を選択する**と上書きできます。ピッカーは過去の日付をブロックします。リクエストが処理される時点ですでに過ぎている有効期限は無視され、代わりにデフォルトが適用されます。
* 支払者に実用的な余裕を与えてください。数分だけの期間も受け付けられますが、決済を完了する時間はほとんど残りません。特に銀行アプリや店頭での手続きを伴う決済手段では顕著です。

有効期限が過ぎると、背後の注文は最終状態（`ORDER_CLOSE`）に達し、リンクでは決済を完了できなくなります。有効期限がこのページで提供される唯一の失効の仕組みです。

## リンクをキャンセルしたり再利用したりできますか？

**取り消しボタンはありません。** 一覧の行アクションは **Copy URL** のみです。リンクを早期に閉じる必要があり、API 連携がある場合は、一覧に表示される `acquiringOrderId` を使って `POST /api/v1/order/cancel` で背後の注文をキャンセルしてください。キャンセルは注文がまだ開いている間は可能で、成功した後はできません。それ以外の場合は、リンク作成時に短い有効期限を設定してください。

**再利用はできません。** 各リンクはちょうど 1 件の注文とともに作成されます。

| 概念 | 関係 |
| - | - |
| 作成フォームの 1 回の送信 | 1 件のアクワイアリング注文、1 つの `acquiringOrderId`、1 つのリンク |
| 1 つのリンク | 1 回の決済、固定された 1 つの金額 |
| 2 人の顧客、または 2 回目の決済 | 2 つの別々のリンク |

リンクは再利用可能な「支払いページ」ではなく、1 枚のInvoiceとして扱ってください。背後のオブジェクトは通常のアクワイアリング注文であるため、その後の処理はすべて通常どおりに動作します。**Transactions → Payments** に表示され、そこで **Acquiring Order ID** で検索でき、他の注文と同様に返金、照合、精算されます。

## 作成したリンクと、支払われたかどうかはどこで確認できますか？

**Payment Link** の一覧には、新しい順に次が表示されます。

| 列 | 意味 |
| - | - |
| Order Description | 作成時に入力した内容 |
| Product | `ONE_TIME_PAYMENT` / `DIRECT_PAYMENT` |
| Country | 作成時に選択した支払者の国 |
| Price | 注文金額と集金通貨 |
| Acquiring Order ID | Waffo の注文 ID — 他の場所で注文を調べるためのキー |
| Status | 背後の注文の現在のステータス |
| Created Time / Created By | 作成日時と、作成した Portal ユーザー |
| Order Expired At | 実効の有効期限。デフォルトはツールチップで説明されます |
| Action | **Copy URL** |

ステータスの値は、**Transactions → Payments** ですでに目にしている注文ステータスです：`AUTHORIZATION_REQUIRED`（リンク発行済み、支払者は未完了）、`PAY_IN_PROGRESS`、`AUTHED_WAITING_CAPTURE`、`CAPTURE_IN_PROGRESS`、`PAY_SUCCESS`、`ORDER_CLOSE`（クローズ済み。期限切れや放棄されたリンクを含む）。

このページは分析ビューではなく作成ログです。フィルターもエクスポートもありません。フィルタリング、取引の詳細、返金、領収書については、Acquiring Order ID を使って **Transactions → Payments** から操作してください。

## リンクの作成に失敗しました。どうすればよいですか？

作成では API の注文作成と同じ検証が実行されるため、通常の原因が当てはまります。契約で有効になっていないプロダクト・国・通貨、または貴社アカウントでは提供できない決済手段の組み合わせです。エラーメッセージは問題のあるパラメータ名を示します。まず **Service → Payin** ページと照らし合わせて確認してください。

***

このページに載っていない挙動（再利用可能なリンク、注文に自社の注文 ID を載せる、プログラムからの作成）が必要ですか？それが[API 連携](/docs/ja/developer-docs/integration/api/overview)の経路の目的です。特定のリンクの動作がおかしい場合は、Acquiring Order ID を添えて[サポートにお問い合わせください](mailto:support@waffo.com)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.