バージョン: 最新版

Links API (決済リンク)

Links APIを使用すると、完全なeコマース統合なしに顧客が支払いを行える共有可能な決済リンクを作成できます。決済リンクは請求書、一回限りの支払い、コード不要の決済ソリューションに最適です。

概要

決済リンクが提供するもの:

コード不要の決済受付 - チェックアウトを構築せずに支払いを受け付け
共有可能なURL - メール、SMS、ソーシャルメディア、メッセージアプリでリンクを送信
カスタマイズ可能な金額 - 固定金額を設定するか、顧客が選択可能に
複数の支払い方法 - クレジットカードと代替決済方法をサポート
クイックセットアップ - APIまたはダッシュボードで即座にリンクを作成
支払い追跡 - リンクの使用状況と支払いステータスを監視

決済リンクの仕組み

リンク作成 - 金額、通貨、説明を含む決済リンクを生成
リンク共有 - メール、SMS、チャットで顧客に固有のURLを送信
顧客の支払い - 顧客がリンクをクリックしてOmiseホスティングページで支払いを完了
通知受信 - 支払い完了時にWebhook通知を受信
ステータス追跡 - リンクの課金と支払いステータスを監視

ユースケース

請求書支払い

B2BまたはB2C取引の請求書に決済リンクを送信します。

ソーシャルコマース

ソーシャルメディア、WhatsApp、Line、その他のメッセージプラットフォームで決済リンクを共有します。

手動注文

電話注文やカスタマーサービス取引用の決済リンクを作成します。

イベント登録

イベントチケット、ワークショップ料金、登録用の決済リンクを送信します。

コンサルティング＆サービス

コンサルティングセッション、フリーランス作業、サービスの支払いを受け付けます。

サブスクリプション更新

手動サブスクリプション更新用の決済リンクを送信します。

主な機能

カスタマイズ可能な金額

固定金額 - 顧客が支払う特定の金額を設定
顧客指定金額 - 顧客が任意の金額を入力可能（寄付、チップ）
複数通貨サポート - THB、SGD、MYR、JPY、USDなどで支払いを受け付け

柔軟な使用方法

一回使用 - 最初の成功した支払い後にリンクが期限切れ
複数使用 - 同じリンクで複数の支払いを許可
有効期限 - リンクの有効期限を設定

リッチなメタデータ

カスタム説明 - 顧客に商品/サービスの詳細を表示
参照データ - 請求書番号、注文ID、顧客参照を保存
メタデータ - 追跡用のカスタムキー値ペアを追加

支払い方法

クレジット/デビットカード（Visa、Mastercard、JCBなど）
PromptPay QR
モバイルバンキング
インターネットバンキング
通貨に基づくその他の支払い方法

利用可能なエンドポイント

決済リンク作成 - POST /links
決済リンク取得 - GET /links/:id
全決済リンク一覧 - GET /links

リンクの状態

Active

リンクがアクティブで支払いを受け付け可能。

Used

リンクが使用済み（一回使用リンクのみ）。

Expired

リンクの有効期限が切れた。

ベストプラクティス

推奨事項

説明的なタイトルを設定 して顧客が何の支払いか分かるようにする
説明またはメタデータに参照番号を含める
適切な有効期限を設定（通常7〜30日）
Webhooksを使用 して成功した支払いの通知を受け取る
メタデータと説明でリンクの使用状況を追跡
顧客に送信する前にリンクをテスト
リンクの説明にカスタマーサポート情報を提供

非推奨事項

期限切れのリンクを再利用しない - 代わりに新しいリンクを作成
時間的に敏感な支払いの有効期限を設定し忘れない
特定の顧客向けのリンクを公開しない
即座の支払いを想定しない - 顧客は遅延する可能性がある
説明なしでリンクを作成しない - 顧客にはコンテキストが必要

セキュリティに関する考慮事項

リンクのプライバシー

リンクはURLを知っている人なら誰でもアクセス可能
機密性の高い取引には一回使用リンクを検討
リンクの説明に機密情報を含めない
リンクはURLを持つ人なら誰でも支払い可能

支払い検証

Webhooksを使用して成功した支払いを検証
課金IDをリンクIDと照合
支払い金額が期待値と一致することを検証
照合のために注文記録とリンクIDを保存

Webhooks

決済リンクは以下のWebhookイベントをトリガーします:

charge.create - 顧客が支払いプロセスを開始
charge.complete - 支払いが正常に完了
charge.update - 支払いステータスが変更

統合例

決済リンク付きメール請求書

請求書 #12345
請求額: ¥10,000

以下のリンクをクリックしてお支払いください:
https://pay.omise.co/links/link_test_...

ご利用ありがとうございます！

WhatsApp/Lineメッセージ

[顧客名]様へ

ご注文金額は ฿500.00 です

こちらからお支払いください: https://pay.omise.co/links/link_test_...

ご質問はこのメッセージに返信してください！

SMS支払いリマインダー

支払いリマインダー: 請求書 #12345 ($100.00) の支払い期限です。
今すぐ支払う: https://pay.omise.co/links/link_test_...

概要​

決済リンクの仕組み​

ユースケース​

請求書支払い​

ソーシャルコマース​

手動注文​

イベント登録​

コンサルティング＆サービス​

サブスクリプション更新​

主な機能​

カスタマイズ可能な金額​

柔軟な使用方法​

リッチなメタデータ​

支払い方法​

利用可能なエンドポイント​

リンクの状態​

Active​

Used​

Expired​

ベストプラクティス​

推奨事項​

非推奨事項​

セキュリティに関する考慮事項​

リンクのプライバシー​

支払い検証​

Webhooks​

統合例​

決済リンク付きメール請求書​

WhatsApp/Lineメッセージ​

SMS支払いリマインダー​

関連リソース​

概要