# Vipps MobilePay ゲートウェイ

Vipps MobilePay ゲートウェイを使用すると、WCPOS内で直接電話ベースの支払いを受け入れることができます。顧客は画面上のQRコードをスキャンするか、電話でプッシュ通知を確認することで支払います—カードリーダーハードウェアは必要ありません。

## 特徴[​](#features "特徴への直接リンク")

#### QRコード支払い

顧客がスキャンして電話で支払うために、チェックアウト時にQRコードを表示します。

#### プッシュ通知

顧客の電話番号を入力して、直接顧客の電話に支払いリクエストを送信します。

#### 北欧地域のサポート

ノルウェーのVipps、デンマークとフィンランドのMobilePayで機能します。

#### 自動キャプチャ

認証後すぐに資金をキャプチャするか、手動キャプチャのために予約します。

## インストール[​](#installation "インストールへの直接リンク")

1

#### ダウンロードとインストール

1. [WCPOS Vipps MobilePayリリースページ](https://github.com/wcpos/wcpos-vipps/releases)にアクセスします。
2. 最新の**wcpos-vipps.zip**ファイルをダウンロードします。
3. WordPress管理画面に移動し、`プラグイン > 新規追加 > プラグインのアップロード`を選択します。
4. zipファイルをアップロードしてプラグインを有効化します。

2

#### Vippsの認証情報を設定

1. `WP管理 > WooCommerce > 設定 > 支払い`に移動します。

2. 支払い方法のリストで**WCPOS Vipps MobilePay**を見つけます。

3. **WCPOS Vipps MobilePay**をクリックして設定にアクセスします。

4. [Vippsポータル](https://portal.vipps.no/)からの認証情報を入力します：

   <!-- -->

   * **マーチャントシリアルナンバー (MSN)**
   * **クライアントID**
   * **クライアントシークレット**
   * **サブスクリプションキー**

5. 設定を保存します。

ノート

ここでPOS用のゲートウェイを有効にする必要はありません—次のステップで具体的にPOS用に有効になります。WooCommerceの設定で有効にすると、オンラインストアのチェックアウトでも利用可能になりますが、テストには便利です。

すでにVippsプラグインを使用していますか？

公式の[Checkout with Vipps MobilePay](https://wordpress.org/plugins/woo-vipps/)プラグインがインストールされている場合、このプラグインを有効化すると自動的に認証情報がインポートされます。手動での認証情報の入力をスキップできます。

3

#### WCPOSで有効化

1. `WP管理 > POS > 設定 > チェックアウト`に移動します。
2. リストで**WCPOS Vipps MobilePay**ゲートウェイを見つけます。
3. POSで使用するためにゲートウェイを有効にします。
4. 設定を保存します。

## 使用法[​](#usage "使用法への直接リンク")

### 支払い処理 — QRコード[​](#processing-payments-qr-code "支払い処理 — QRコードへの直接リンク")

1. **アイテムを追加**: POSでカートに商品を追加します。
2. **ゲートウェイを選択**: 支払い方法として「Vipps MobilePay」を選択します。
3. **QRコードを生成**: 「QRコードを生成」ボタンをクリックします。
4. **顧客がスキャン**: 顧客が自分のVippsまたはMobilePayアプリでQRコードをスキャンします。
5. **顧客が確認**: 顧客がアプリで支払いを確認します。
6. **自動完了**: 支払いが承認されると、注文が自動的に完了します。

### 支払い処理 — 電話に送信[​](#processing-payments-send-to-phone "支払い処理 — 電話に送信への直接リンク")

1. **アイテムを追加**: POSでカートに商品を追加します。
2. **ゲートウェイを選択**: 支払い方法として「Vipps MobilePay」を選択します。
3. **電話番号を入力**: 顧客の電話番号を入力します。
4. **電話に送信**: 「電話に送信」ボタンをクリックします。
5. **顧客が確認**: 顧客がプッシュ通知を受け取るか、Vippsのランディングページにリダイレクトされ、そこでアプリで支払いを確認します。
6. **自動完了**: 支払いが承認されると、注文が自動的に完了します。

プラグインは、顧客の電話に支払いリクエストを送信するための最適な方法を自動的に検出します：

* **直接プッシュ**（推奨）— 顧客のVippsアプリに通知を直接送信します。これが最も迅速な体験ですが、販売単位で`PUSH_MESSAGE`を有効にする必要があります（以下の[直接プッシュの有効化](#enabling-direct-push)を参照）。
* **ランディングページのフォールバック** — 直接プッシュが有効でない場合、プラグインは新しいブラウザタブでVippsのランディングページを開きます。このランディングページが通知の送信を処理します。これは特別な承認なしにすぐに機能します。

プラグインが初めて直接プッシュが利用できないことを検出したときは、「再度電話に送信」をクリックするように求めるメッセージが表示されます。その後は、結果を記憶し、シームレスに機能します。

### 直接プッシュの有効化[​](#enabling-direct-push "直接プッシュの有効化への直接リンク")

直接プッシュのフローは、電話支払いのための最適な体験を提供します — 余分なタブやランディングページが不要です。有効にするには：

1. [portal.vippsmobilepay.com](https://portal.vippsmobilepay.com)にログインします。
2. Vippsのキーアカウントマネージャー、パートナーマネージャー、またはカスタマーサービスに連絡します。
3. 彼らに伝えます：**「POS統合に使用するために私のMSNでPUSH\_MESSAGEを有効にする必要があります」**

承認されると、プラグインは変更を24時間以内に自動的に検出し、直接プッシュフローに切り替わります。ランディングページのフォールバックを使用している間、ゲートウェイ設定ページにリマインダーノートが表示されます。

### 支払いのキャンセル[​](#cancelling-a-payment "支払いのキャンセルへの直接リンク")

顧客の確認を待っている間、**支払いをキャンセル**ボタンをクリックしてトランザクションを中止できます。これにより、Vipps側の保留中の支払いがキャンセルされ、チェックアウトインターフェースがリセットされます。

### 返金[​](#refunds "返金への直接リンク")

返金は標準のWooCommerce返金プロセスを介して処理されます。注文を開いて**返金**をクリックし、金額を入力すると、Vipps APIを通じて自動的に返金が処理されます。

## 対応市場[​](#supported-markets "対応市場への直接リンク")

Vipps MobilePayは、2つのブランドで北欧地域で運営されています：

| 地域                     | ブランド  | 通貨     |
| ------------------------ | --------- | -------- |
| ノルウェー               | Vipps     | NOK      |
| デンマーク、フィンランド | MobilePay | DKK, EUR |

あなたのマーチャントアカウントによって、利用可能な市場と通貨が決まります。サポートされている市場の顧客は、自分のローカルVippsまたはMobilePayアプリを使用して支払いを行うことができます。

## 要件[​](#requirements "要件への直接リンク")

Vippsアカウント

<!-- -->

: API認証情報を持つアクティブなVipps MobilePayマーチャントアカウント

API認証情報

<!-- -->

: マーチャントシリアルナンバー、クライアントID、クライアントシークレット、およびサブスクリプションキー

WCPOS

<!-- -->

: POSチェックアウトに必要なプロ版。ゲートウェイは、スタンダードWooCommerceのウェブチェックアウトでも動作しますが、プロ版は必要ありません。

HTTPS

<!-- -->

: あなたのサイトはSSL/HTTPSを使用する必要があります（Vipps APIによって要求されます）

## トラブルシューティング[​](#troubleshooting "トラブルシューティングへの直接リンク")

### 一般的な問題[​](#common-issues "一般的な問題への直接リンク")

支払いが完了しない

* チェックアウトは最大5分間ポーリングします—顧客がそのウィンドウ内に確認しない場合、支払いがタイムアウトします。
* テストモードと本番認証情報を混同していないか確認します。
* POSデバイスと顧客の電話の両方で、インターネット接続が安定していることを確認します。

無効な認証情報エラー

* すべての4つの認証情報フィールド（MSN、クライアントID、クライアントシークレット、サブスクリプションキー）を再チェックします。
* テストモードが有効なときにはテスト認証情報を使用し、無効なときには本番認証情報を使用していることを確認します。
* [Vippsポータル](https://portal.vipps.no/)で認証情報を確認します。

'電話に送信'が新しいタブを開く代わりに直接送信しない

これは、あなたのVippsアカウントがまだ`PUSH_MESSAGE`を有効にしていないことを意味します。プラグインはフォールバックとしてランディングページを使用していますが、これは機能しますが追加のステップが必要です。スムーズな直接プッシュ体験を得るために、Vippsに連絡し、あなたの販売単位（MSN）でPUSH\_MESSAGEを有効にするように頼んでください。上記の[直接プッシュの有効化](#enabling-direct-push)を参照してください。

QRコードが生成されない

* あなたのサイトがHTTPSで運用されていることを確認します—Vipps APIはHTTPサイトからのリクエストを拒否します。
* APIエラーの詳細についてはWooCommerceのログ（`WooCommerce > ステータス > ログ`）を確認します。
* あなたのマーチャントアカウントがアクティブであり、ePayment APIが有効になっていることを確認します。

### ヘルプを得る[​](#getting-help "ヘルプを得るへの直接リンク")

技術サポートについて：

* [GitHubリポジトリ](https://github.com/wcpos/wcpos-vipps)を訪れて問題を報告します。
* APIに関する質問については、[Vipps開発者ドキュメント](https://developer.vippsmobilepay.com/)を確認します。
* アカウントや認証情報の問題については、Vipps MobilePayサポートに連絡します。

## スクリーンショット[​](#screenshots "スクリーンショットへの直接リンク")

スクリーンショットは、将来の更新で追加される予定です：

* WooCommerce支払い設定でのゲートウェイ設定
* QRコードとプッシュ通知オプションを持つPOSチェックアウトインターフェース
* 支払い確認フロー