Vipps MobilePay ゲートウェイ
Vipps MobilePay ゲートウェイを使用すると、WCPOS内で直接電話ベースの支払いを受け入れることができます。顧客は画面上のQRコードをスキャンするか、電話でプッシュ通知を確認することで支払います—カードリーダーハードウェアは必要ありません。
特徴
QRコード支払い
顧客がスキャンして電話で支払うために、チェックアウト時にQRコードを表示します。
プッシュ通知
顧客の電話番号を入力して、直接顧客の電話に支払いリクエストを送信します。
北欧地域のサポート
ノルウェーのVipps、デンマークとフィンランドのMobilePayで機能します。
自動キャプチャ
認証後すぐに資金をキャプチャするか、手動キャプチャのために予約します。
インストール
ダウンロードとインストール
- WCPOS Vipps MobilePayリリースページにアクセスします。
- 最新のwcpos-vipps.zipファイルをダウンロードします。
- WordPress管理画面に移動し、
プラグイン > 新規追加 > プラグインのアップロードを選択します。 - zipファイルをアップロードしてプラグインを有効化します。
Vippsの認証情報を設定
WP管理 > WooCommerce > 設定 > 支払いに移動します。- 支払い方法のリストでWCPOS Vipps MobilePayを見つけます。
- WCPOS Vipps MobilePayをクリックして設定にアクセスします。
- Vippsポータルからの認証情報を入力します：
- マーチャントシリアルナンバー (MSN)
- クライアントID
- クライアントシークレット
- サブスクリプションキー
- 設定を保存します。
ここでPOS用のゲートウェイを有効にする必要はありません—次のステップで具体的にPOS用に有効になります。WooCommerceの設定で有効にすると、オンラインストアのチェックアウトでも利用可能になりますが、テストには便利です。
公式のCheckout with Vipps MobilePayプラグインがインストールされている場合、このプラグインを有効化すると自動的に認証情報がインポートされます。手動での認証情報の入力をスキップできます。
WCPOSで有効化
WP管理 > POS > 設定 > チェックアウトに移動します。- リストでWCPOS Vipps MobilePayゲートウェイを見つけます。
- POSで使用するためにゲートウェイを有効にします。
- 設定を保存します。
使用法
支払い処理 — QRコード
- アイテムを追加: POSでカートに商品を追加します。
- ゲートウェイを選択: 支払い方法として「Vipps MobilePay」を選択します。
- QRコードを生成: 「QRコードを生成」ボタンをクリックします。
- 顧客がスキャン: 顧客が自分のVippsまたはMobilePayアプリでQRコードをスキャンします。
- 顧客が確認: 顧客がアプリで支払いを確認します。
- 自動完了: 支払いが承認されると、注文が自動的に完了します。
支払い処理 — 電話に送信
- アイテムを追加: POSでカートに商品を追加します。
- ゲートウェイを選択: 支払い方法として「Vipps MobilePay」を選択します。
- 電話番号を入力: 顧客の電話番号を入力します。
- 電話に送信: 「電話に送信」ボタンをクリックします。
- 顧客が確認: 顧客がプッシュ通知を受け取るか、Vippsのランディングページにリダイレクトされ、そこでアプリで支払いを確認します。
- 自動完了: 支払いが承認されると、注文が自動的に完了します。
プラグインは、顧客の電話に支払いリクエストを送信するための最適な方法を自動的に検出します：
- 直接プッシュ（推奨）— 顧客のVippsアプリに通知を直接送信します。これが最も迅速な体験ですが、販売単位で
PUSH_MESSAGEを有効にする必要があります（以下の直接プッシュの有効化を参照）。 - ランディングページのフォールバック — 直接プッシュが有効でない場合、プラグインは新しいブラウザタブでVippsのランディングページを開きます。このランディングページが通知の送信を処理します。これは特別な承認なしにすぐに機能します。
プラグインが初めて直接プッシュが利用できないことを検出したときは、「再度電話に送信」をクリックするように求めるメッセージが表示されます。その後は、結果を記憶し、シームレスに機能します。
直接プッシュの有効化
直接プッシュのフローは、電話支払いのための最適な体験を提供します — 余分なタブやランディングページが不要です。有効にするには：
- portal.vippsmobilepay.comにログインします。
- Vippsのキーアカウントマネージャー、パートナーマネージャー、またはカスタマーサービスに連絡します。
- 彼らに伝えます：「POS統合に使用するために私のMSNでPUSH_MESSAGEを有効にする必要があります」
承認されると、プラグインは変更を24時間以内に自動的に検出し、直接プッシュフローに切り替わります。ランディングページのフォールバックを使用している間、ゲートウェイ設定ページにリマインダーノートが表示されます。
支払いのキャンセル
顧客の確認を待っている間、支払いをキャンセルボタンをクリックしてトランザクションを中止できます。これにより、Vipps側の保留中の支払いがキャンセルされ、チェックアウトインターフェースがリセットされます。
返金
返金は標準のWooCommerce返金プロセスを介して処理されます。注文を開いて返金をクリックし、金額を入力すると、Vipps APIを通じて自動的に返金が処理されます。
対応市場
Vipps MobilePayは、2つのブランドで北欧地域で運営されています：
| 地域 | ブランド | 通貨 |
|---|---|---|
| ノルウェー | Vipps | NOK |
| デンマーク、フィンランド | MobilePay | DKK, EUR |
あなたのマーチャントアカウントによって、利用可能な市場と通貨が決まります。サポートされている市場の顧客は、自分のローカルVippsまたはMobilePayアプリを使用して支払いを行うことができます。
要件
トラブルシューティング
一般的な問題
支払いが完了しない
- チェックアウトは最大5分間ポーリングします—顧客がそのウィンドウ内に確認しない場合、支払いがタイムアウトします。
- テストモードと本番認証情報を混同していないか確認します。
- POSデバイスと顧客の電話の両方で、インターネット接続が安定していることを確認します。
無効な認証情報エラー
- すべての4つの認証情報フィールド（MSN、クライアントID、クライアントシークレット、サブスクリプションキー）を再チェックします。
- テストモードが有効なときにはテスト認証情報を使用し、無効なときには本番認証情報を使用していることを確認します。
- Vippsポータルで認証情報を確認します。
'電話に送信'が新しいタブを開く代わりに直接送信しない
これは、あなたのVippsアカウントがまだPUSH_MESSAGEを有効にしていないことを意味します。プラグインはフォールバックとしてランディングページを使用していますが、これは機能しますが追加のステップが必要です。スムーズな直接プッシュ体験を得るために、Vippsに連絡し、あなたの販売単位（MSN）でPUSH_MESSAGEを有効にするように頼んでください。上記の直接プッシュの有効化を参照してください。
QRコードが生成されない
- あなたのサイトがHTTPSで運用されていることを確認します—Vipps APIはHTTPサイトからのリクエストを拒否します。
- APIエラーの詳細についてはWooCommerceのログ（
WooCommerce > ステータス > ログ）を確認します。 - あなたのマーチャントアカウントがアクティブであり、ePayment APIが有効になっていることを確認します。
ヘルプを得る
技術サポートについて：
- GitHubリポジトリを訪れて問題を報告します。
- APIに関する質問については、Vipps開発者ドキュメントを確認します。
- アカウントや認証情報の問題については、Vipps MobilePayサポートに連絡します。
スクリーンショット
スクリーンショットは、将来の更新で追加される予定です：
- WooCommerce支払い設定でのゲートウェイ設定
- QRコードとプッシュ通知オプションを持つPOSチェックアウトインターフェース
- 支払い確認フロー