連携ではなく支払いリンクを使うべきなのはどんなときですか？
両者は 2 つの別プロダクトではなく同じ仕組みです。支払いリンクは API 注文と同じ注文作成パスを通じて作成され、コピーする URL は API 連携で
orderAction.webUrl が返すのと同じホスト型決済ページです。異なるのは誰が注文を作成するか、Portal か貴社のサーバーか、という点だけです。
リンクを作成するとき何を入力しますか？
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 枚のInvoiceとして扱ってください。背後のオブジェクトは通常のアクワイアリング注文であるため、その後の処理はすべて通常どおりに動作します。Transactions → Payments に表示され、そこで Acquiring Order ID で検索でき、他の注文と同様に返金、照合、精算されます。
作成したリンクと、支払われたかどうかはどこで確認できますか？
Payment Link の一覧には、新しい順に次が表示されます。
ステータスの値は、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 連携の経路の目的です。特定のリンクの動作がおかしい場合は、Acquiring Order ID を添えてサポートにお問い合わせください。