統合パスを選択
どの統合方法が適しているかわかりませんか? このガイドは、ニーズに基づいてプラグイン、SDK、直接API統合の選択を支援します。
クイック決定ツリー
統合方法の比較
1. Eコマースプラグイン(ノーコード)
最適: 人気のプラットフォームを使用するオンラインストア
長所:
- ✅ コーディング不要
- ✅ 迅速なセットアップ(15〜30分)
- ✅ テスト済みでメンテナンス済み
- ✅ 複数の決済方法をサポート
- ✅ 自動更新
短所:
- ❌ カスタマイズが制限される
- ❌ プラットフォーム固有
- ❌ 機能制限がある場合がある
利用可能なプラットフォーム:
👉 ここから始める場合: これらのプラットフォームのいずれかでEコマースストアを運営していて、最速のセットアップが必要な場合。
2. Omise.js(ローコード)
最適: 最小限のバックエンドカスタマイズニーズを持つウェブサイトとウェブアプリ
長所:
- ✅ 事前構築された決済フォーム
- ✅ Tokenizationを自動処理
- ✅ PCI準拠が簡素化される
- ✅ 任意のバックエンドで動作
- ✅ カスタマイズ可能なスタイリング
短所:
- ❌ UIの制御が少ない
- ❌ バックエンド統合が必要
- ❌ JavaScriptが必要
統合時間: 2〜4時間
コード例:
<!-- Omise.jsを含める -->
<script src="https://cdn.omise.co/omise.js"></script>
<!-- 決済フォーム -->
<form id="checkout">
<script type="text/javascript"
src="https://cdn.omise.co/omise.js"
data-key="pkey_test_YOUR_KEY"
data-amount="100000"
data-currency="thb"
data-button-label="今すぐ支払う">
</script>
</form>
👉 ここから始める場合: 「すぐに使える」決済フォームで迅速なウェブ統合が必要で、大幅なカスタマイズが不要な場合。
3. Mobile SDK
最適: ネイティブモバイルアプリケーションとクロスプラットフォームアプリ
長所:
- ✅ ネイティブUIコンポーネント
- ✅ プラットフォームのベストプラクティス
- ✅ Tokenizationを処理
- ✅ 組み込みのエラーハンドリング
- ✅ モバイル 用に最適化
短所:
- ❌ プラットフォーム固有(Flutterを除く)
- ❌ バックエンド統合が必要
- ❌ SDK更新のためのアプリ更新
利用可能なSDK:
- iOS: Swift/Objective-C
- Android: Java/Kotlin
- Flutter: Dart(クロスプラットフォーム)
- React Native: JavaScript(クロスプラットフォーム)
統合時間: 1〜2日
👉 ここから始める場合: モバイルアプリを構築していて、ネイティブの決済UIコンポーネントが必要な場合。
4. サーバーライブラリ + カスタムフロントエンド
最適: 完全な制御要件を持つカスタムアプリケーション
長所:
- ✅ 完全なカスタマイズ
- ✅ UXの完全な制御
- ✅ 複数の言語サポート
- ✅ すべての機能が利用可能
- ✅ 直接APIアクセス
短所:
- ❌ より多くの開発時間
- ❌ より多くのテストが必要
- ❌ より高いメンテナンス
- ❌ より多くのPCI考慮事項
利用可能なライブラリ:
- Ruby、Python、PHP、Node.js
- Java、Go、.NET、Elixir
統合時間: 1〜3日
👉 ここから始める場合: 最大の柔軟性が必要で、カスタム実装のための開発リソースがある場合。
5. REST API(直接)
最適: 任意の言語でのカスタム統合
長所:
- ✅ 任意の言語で動作
- ✅ 完全なAPIアクセス
- ✅ 最大の柔軟性
- ✅ ライブラリ依存性なし
短所:
- ❌ 最も多くの開発労力
- ❌ 手動のエラーハンドリング
- ❌ すべてを実装する必要がある
- ❌ より多くのメンテナンス
統合時間: 2〜5日
👉 ここから始める場合: 公式ライブラリがない言語を使用している場合、または非常にカスタムな統合が必要な場合。
6. Payment Links(ノーコード)
最適: シンプルな販売、請求書、ソーシャルメディアコマース
長所:
- ✅ コーディング不要
- ✅ 即座のセットアップ
- ✅ 任意のチャネルで共有可能
- ✅ ホストされたチェックアウトページ
- ✅ モバイルフレンドリー
短所:
- ❌ カスタマイズなし
- ❌ 外部チェックアウト体験
- ❌ 限定的な自動化
- ❌ 手動プロセス
セットアップ時間: 5分
👉 ここから始める場合: 何も構築せずにすぐに決済を受け付ける必要がある場合。
機能比較マトリックス
| Payment Method | セットアップ時間 | コーディング必要 | カスタマイズ | メンテナンス | すべての決済方法 | モバイル対応 | 難易度 |
|---|---|---|---|---|---|---|---|
| Eコマースプラグイン | 15〜30分 | ❌ | 低 | 低 | ✅ | ✅ | 簡単 |
| Omise.js | 2〜4時間 | ✅ | 中 | 低 | ✅ | ✅ | 中 |
| Mobile SDK | 1〜2日 | ✅ | 高 | 中 | ✅ | ✅ | 中 |
| サーバーライブラリ | 1〜3日 | ✅ | 高 | 中 | ✅ | ❌ | 難 |
| REST API | 2〜5日 | ✅ | 完全 | 高 | ✅ | ❌ | 難 |
| Payment Links | 5分 | ❌ | なし | なし | ✅ | ✅ | 簡単 |
使用例別
サブスクリプション/継続課金
推奨: サーバーライブラリ + Omise.js
理由: 顧客の決済方法を保存し、繰り返しchargeする必要があります。これにはバックエンドロジックが必 要です。
必要な機能:
- Customer管理
- カード保存
- スケジュールされたcharge
- Webhook処理
1回限りの購入
推奨: Omise.jsまたはEコマースプラグイン
理由: 複雑な要件のないシンプルなチェックアウトフロー。
必要な機能:
- Token作成
- Charge作成
- 基本的なエラーハンドリング
マーケットプレイス/プラットフォーム
推奨: 完全なAPI統合
理由: 複数のマーチャントの管理、決済の分割、複雑なフローの処理が必要です。
必要な機能:
- サブマーチャント管理
- Transfer分割
- 高度なレポート
- Chain key
マーケットプレイスソリューションについては営業に連絡してください。
モバイルコマース
推奨: Mobile SDK
理由: 最適化されたUIコンポーネントを持つネイティブモバイル体験。
必要な機能:
- アプリ内のtokenization
- ネイティブ決済フォーム
- 生体認証
- ディープリンキング
国際販売
推奨: 完全なAPI統合
理由: 複数の通貨、地域、決済方法を処理する必要があります。
必要な機能:
- マルチ通貨サポート
- 地域決済方法
- 通貨換算
- ローカライゼーション
技術的考慮事項
PCI準拠
| 方法 | PCI負担 | 理由 |
|---|---|---|
| プラグイン | 最小限 | プラグインがカードデータを処理 |
| Omise.js | 最小限 | Omise.jsがサーバー前にtokenize |
| Mobile SDK | 最小限 | SDKがサーバー前にtokenize |
| サーバーライブラリ | 低 | Tokenizationを使用 |
| REST API | 中 | セキュアに実装する必要がある |
すべての方法は、正しく実装されていれば、カードデータをサーバーから除外します。常にtokenizationを使用してください!
ホスティング要件
| 方法 | 要件 |
|---|---|
| プラグイン | プラットフォームホスティング(管理) |
| Omise.js | HTTPSを使用したウェブホスティング |
| Mobile SDK | App storeデプロイメント |
| サーバーライブラリ | HTTPSを使用したサーバー |
| REST API | HTTPSを使用したサーバー |
| Payment Links | ホスティング不要 |
必要な開発スキル
Eコマースプラグイン:
- プラットフォーム管理
- 基本的な設定
Omise.js:
- HTML/JavaScript
- 基本的なバックエンド開発
- HTTPS/SSL知識
Mobile SDK:
- Swift/Kotlin/Dart
- モバイル開発経験
- バックエンドAPI開発
サーバーライブラリ:
- バックエンドプログラミング
- API統合
- データベース管理
- セキュリティベストプラクティス
REST API:
- HTTP/REST API
- JSON処理
- 認証
- エラーハンドリング
- セキュリティ強化
移行パス
シンプルに始めて、後でスケール
1つの方法から始めて、後で移行できます:
- 開始: Payment Links(即座の販売)
- アップグレード: プラグイン(Eコマース開始)
- スケール: カスタムAPI(高度な機能)
すべての方法は同じOmiseバックエンドを使用します。データ移行なしで、アプローチを切り替えたり組み合わせたりできます。
アプローチの組み合わせ
複数の方法を同時に使用できます:
- ウェブ: Omise.js統合
- モバイル: ネイティブSDK
- 管理: 手動販売用のPayment Links
- バックエンド: 自動化用のサーバーライブラリ
選択に基づく次のステップ
Eコマースプラグインを選択しましたか?
- プラグインでプラットフォームを見つける
- インストールガイドに従う
- 決済方法を設定
- Test modeでテスト
- 本番稼働
Omise.jsを選択しましたか?
- Omise.jsガイドを読む
- ページにスクリプトを含める
- Token処理を実装
- バックエンドchargeエンドポイントを構築
- テストしてデプロイ
Mobile SDKを選択しましたか?
サーバーライブラリを選択しましたか?
- サーバーライブラリで言語を選択
- ライブラリをインストール
- フロントエンドtokenizationを構築
- バックエンドロジックを実装
- Webhookを設定
REST APIを選択しましたか?
- APIドキュメントを確認
- 認証を実装
- Tokenizationフローを構築
- Chargeエンドポイントを作成
- エラーとエッジケースを処理
Payment Linksを選択しましたか?
- ダッシュボードにログイン
- Payment linkを作成
- メール/ソーシャルメディア経由で共有
- ダッシュボードで決済を追跡
FAQ
後で統合方法を切り替えることはできますか?
はい! すべての方法は同じOmiseバックエンドとAPIを使用します。以下が可能です:
- プラグインから始めて、後でカスタム統合に移行
- ウェブ用にプラグインを、モバイル用にSDKを同時に使用
- データを失うことなくアプローチ間を移行
Charge、customer、トランザクションは、統合方法に関係なくOmiseアカウントに残ります。
どの方法が最もセキュアですか?
すべての方法は、正しく実装されていればセキュアです。重要なのは:
- 常にtokenizationを使用(すべての方法がこれを行います)
- サーバーにカードデータを保存しない
- すべての接続にHTTPSを使用
- Secret keyをサーバーのみに保持
プラグインとOmise.jsは、カードデータ処理が組み込まれているため、実装リスクが少し低くなります。
どの方法が最も多くの決済方法を提供しますか?
すべての方法は、Omiseの40以上の決済方法すべてをサポートします。違いは、追加の容易さです:
- プラグイン: 通常、方法を有効にするチェックボックスがあります
- Omise.js: 最小限のコード変更ですべての方法をサポート
- SDK: ネイティブUIですべての方法をサポート
- API: 各新しい方法にコードが必要
ウェブとモバイルで別々の統合が必要ですか?
一般的にはい、ただしバックエンドを共有します:
- フロントエンド: 異なる(ウェブ用Omise.js、モバイル用SDK)
- バックエンド: 同じサーバーコードが両方を処理可能
- ダッシュボード: すべてのトランザクションの単一ビュー
プラットフォーム間でcharge作成バックエンドロジックを再利用できます。
複数の統合方法を同時に使用できますか?
もちろん! 一般的なシナリオ:
- メインストア用プラグイン + オフライン販売用Payment Links
- ウェブ用Omise.js + アプリ用Mobile SDK
- ウェブ用カスタムAPI + レガシーシステム用プラグイン
作成方法に関係なく、すべてのトランザクションがダッシュボードに表示されます。
プラットフォーム/言語がサポートされていない場合はどうすればよいですか?
REST APIを直接使用してください! 以下が可能な任意の言語で動作します:
- HTTPリクエストを行う
- JSONを解析する
- HTTPSを処理する
特定のニーズに合わせてAPIの薄いラッパーを構築することもできます。
まだ迷っていますか?
これを試してください:
- Payment Linksから始める(5分)で最初の販売を行う
- クイックスタートを探索して基本を理解する
- お問い合わせ選択のサポートが必要な場合: support@omise.co
またはクイックスタートガイドですぐにテストを始めましょう!
構築の準備はできましたか? 上記からパスを選択して統合を開始しましょう!