バージョン: 最新版

Links API (決済リンク)

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

概要

決済リンクは以下を提供します:

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

決済リンクの仕組み

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

ユースケース

請求書決済

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

ソーシャルコマース

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

手動注文

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

イベント登録

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

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

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

サブスクリプション更新

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

主な機能

カスタマイズ可能な金額

固定金額 - 顧客が支払う必要がある特定の金額を設定
顧客指定金額 - 顧客が任意の金額を入力できるようにする(寄付、チップ)
複数通貨サポート - THB、SGD、MYR、JPY、USDなどで決済を受け付ける

柔軟な使用

1回限りの使用 - 最初の成功した決済後にリンクが期限切れになる
複数回使用 - 同じリンクで複数の決済を許可
有効期限 - リンクの有効期限を設定

豊富なメタデータ

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

決済方法

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

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

リンクの状態

アクティブ

リンクはアクティブで、決済を受け付けることができます。

使用済み

リンクは使用されました(1回限りのリンクのみ)。

期限切れ

リンクは有効期限を過ぎています。

ベストプラクティス

✅ 推奨事項

わかりやすいタイトルを設定 - 顧客が何に対して支払うかを理解できるようにする
参照番号を含める - 説明またはメタデータに含める
妥当な有効期限を設定 - 通常7〜30日
Webhookを使用 - 成功した決済の通知を受け取る
リンクの使用状況を追跡 - メタデータと説明を介して追跡
リンクをテスト - 顧客に送信する前にテスト
カスタマーサポート情報を提供 - リンクの説明に含める

❌ 避けるべきこと

期限切れリンクを再利用しない - 代わりに新しいリンクを作成
有効期限の設定を忘れない - 期限付き決済の場合
リンクを公開で共有しない - 特定の顧客向けの場合
即座の決済を想定しない - 顧客は遅れる可能性があります
説明なしでリンクを作成しない - 顧客にはコンテキストが必要です

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

リンクのプライバシー

リンクはURLを持つ誰でも公開アクセス可能です
機密性の高い取引には1回限りのリンクの使用を検討してください
リンクの説明に機密情報を含めないでください
リンクはURLを持つ誰でも支払うことができます

決済の検証

Webhookを使用して成功した決済を検証
リンクIDに対してチャージIDを確認
決済金額が期待値と一致することを検証
照合のためにリンクIDを注文記録と一緒に保存

Webhooks

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

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

統合例

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

請求書 #12345
支払額: $100.00

以下のリンクをクリックして支払いを行ってください:
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_...

概要​

決済リンクの仕組み​

ユースケース​

請求書決済​

ソーシャルコマース​

手動注文​

イベント登録​

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

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

主な機能​

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

柔軟な使用​

豊富なメタデータ​

決済方法​

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

リンクの状態​

アクティブ​

使用済み​

期限切れ​

ベストプラクティス​

✅ 推奨事項​

❌ 避けるべきこと​

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

リンクのプライバシー​

決済の検証​

Webhooks​

統合例​

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

WhatsApp/Lineメッセージ​

SMS決済リマインダー​

関連リソース​

概要