# Vipps MobilePay 网关

Vipps MobilePay 网关允许您在 WCPOS 中直接接受基于电话的支付。客户可以通过扫描屏幕上的二维码或在他们的手机上确认推送通知进行付款，无需卡读设备。

## 功能[​](#features "直接链接到 功能")

#### 二维码支付

在结账时显示二维码，供客户扫描并使用手机支付

#### 推送通知

通过输入客户的号码直接向客户的手机发送付款请求

#### 北欧覆盖

在挪威使用 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 Admin > WooCommerce > 设置 > 支付`

2. 在支付方式列表中找到 **WCPOS Vipps MobilePay**

3. 点击 **WCPOS Vipps MobilePay** 进入设置

4. 输入您在 [Vipps 门户](https://portal.vipps.no/) 中的证书：

   <!-- -->

   * **商户序列号 (MSN)**
   * **客户端 ID**
   * **客户端密钥**
   * **订阅键**

5. 保存设置

注意

您不需要在这里为 POS 使用启用网关 — 它将在下一步中专门为 POS 启用。在 WooCommerce 设置中启用它也会使其在您的在线商店结账时可用，这对于测试可能很有用。

已经在使用 Vipps 插件？

如果您安装了官方的 [使用 Vipps MobilePay 结账](https://wordpress.org/plugins/woo-vipps/) 插件，则在激活此插件时，您的凭证将自动导入。您可以跳过手动输入凭证的步骤。

3

#### 在 WCPOS 中启用

1. 转到 `WP Admin > POS > 设置 > 结账`
2. 在列表中找到 **WCPOS Vipps MobilePay** 网关
3. 启用该网关以供 POS 使用
4. 保存您的设置

## 使用方法[​](#usage "直接链接到 使用方法")

### 处理支付 — 二维码[​](#processing-payments-qr-code "直接链接到 处理支付 — 二维码")

1. **添加项目**：在 POS 中将产品添加到购物车
2. **选择网关**：选择“Vipps MobilePay”作为支付方式
3. **生成二维码**：点击“生成二维码”按钮
4. **客户扫描**：客户使用他们的 Vipps 或 MobilePay 应用扫描二维码
5. **客户确认**：客户在他们的应用中确认付款
6. **自动完成**：一旦付款获得授权，订单将自动完成

### 处理支付 — 发送到手机[​](#processing-payments-send-to-phone "直接链接到 处理支付 — 发送到手机")

1. **添加项目**：在 POS 中将产品添加到购物车
2. **选择网关**：选择“Vipps MobilePay”作为支付方式
3. **输入电话号码**：输入客户的电话号码
4. **发送到手机**：点击“发送到手机”按钮
5. **客户确认**：客户收到推送通知或被引导到 Vipps 登陆页面，然后在他们的应用中确认付款
6. **自动完成**：一旦付款获得授权，订单将自动完成

该插件会自动检测将付款请求发送到客户手机的最佳方法：

* **直接推送**（首选） — 直接向客户的 Vipps 应用发送通知。这是最快的体验，但需要 Vipps 在您的销售单位上启用 `PUSH_MESSAGE`（见下文 [启用直接推送](#enabling-direct-push)）。
* **登陆页面后备** — 如果未启用直接推送，插件将在新浏览器选项卡中打开 Vipps 登陆页面。登陆页面处理发送通知。这在没有特殊批准的情况下立即可用。

第一次插件检测到直接推送不可用时，您会看到一条简短消息，提示您再次点击“发送到手机”。之后，它会记住结果并无缝工作。

### 启用直接推送[​](#enabling-direct-push "直接链接到 启用直接推送")

直接推送流程为电话支付提供了最佳体验 — 无需额外选项卡，无需登陆页面。要启用它：

1. 登录到 [portal.vippsmobilepay.com](https://portal.vippsmobilepay.com)
2. 联系您的 Vipps 关键客户经理、合作经理或客户服务
3. 告诉他们：**“我需要在我的 MSN 上启用 PUSH\_MESSAGE，以用于 POS 集成”**

一旦获得批准，插件将在 24 小时内自动检测到更改并切换到直接推送流程。使用登陆页面后备时，您将在网关设置页面上看到提醒通知。

### 取消付款[​](#cancelling-a-payment "直接链接到 取消付款")

在等待客户确认期间，您可以点击 **取消付款** 按钮以中止交易。这将在 Vipps 端取消待处理的付款并重置结账界面。

### 退款[​](#refunds "直接链接到 退款")

退款通过标准的 WooCommerce 退款流程处理。打开订单，点击 **退款**，输入金额，退款将通过 Vipps API 自动处理。

## 支持的市场[​](#supported-markets "直接链接到 支持的市场")

Vipps MobilePay 在北欧地区以两个品牌运营：

| 地区       | 品牌      | 货币     |
| ---------- | --------- | -------- |
| 挪威       | Vipps     | NOK      |
| 丹麦，芬兰 | MobilePay | DKK，EUR |

您的商户账户决定可用的市场和货币。在任何支持的市场中，客户均可使用他们本地的 Vipps 或 MobilePay 应用进行支付。

## 资格要求[​](#requirements "直接链接到 资格要求")

Vipps 账户

<!-- -->

: 活跃的 Vipps MobilePay 商户账户和 API 证书

API 证书

<!-- -->

: 商户序列号、客户端 ID、客户端密钥和订阅键

WCPOS

<!-- -->

: 需要 PRO 版本以进行 POS 结账。该网关也可以在没有 PRO 的标准 WooCommerce 网络结账上使用。

HTTPS

<!-- -->

: 您的网站必须使用 SSL/HTTPS（Vipps API 要求）

## 故障排除[​](#troubleshooting "直接链接到 故障排除")

### 常见问题[​](#common-issues "直接链接到 常见问题")

付款未完成

* 结账最多会轮询 5 分钟 — 如果客户在此窗口内未确认，付款将超时
* 检查您是否混淆了测试模式和生产凭证
* 验证 POS 设备和客户手机的互联网连接是否稳定

无效凭证错误

* 检查所有四个凭证字段（MSN、客户端 ID、客户端密钥、订阅键）
* 确保在启用测试模式时使用测试凭证，在禁用时使用生产凭证
* 在 [Vipps 门户](https://portal.vipps.no/) 中验证您的凭证

‘发送到手机’打开新选项卡而不是直接发送

这意味着您的 Vipps 账户尚未启用 `PUSH_MESSAGE`。该插件正在使用登陆页面后备方案，这虽然有效，但增加了一步。要获得更顺畅的直接推送体验，请联系 Vipps 并要求他们在您的销售单位（MSN）上启用 PUSH\_MESSAGE。参见上面的 [启用直接推送](#enabling-direct-push)。

二维码未生成

* 确认您的网站通过 HTTPS 运行 — Vipps API 拒绝来自 HTTP 网站的请求
* 检查 WooCommerce 日志 (`WooCommerce > 状态 > 日志`) 以获取 API 错误详细信息
* 验证您的商户账户是否活跃，并且启用了电子支付 API

### 获取帮助[​](#getting-help "直接链接到 获取帮助")

对于技术支持：

* 访问 [GitHub 仓库](https://github.com/wcpos/wcpos-vipps) 报告问题
* 检查 [Vipps 开发者文档](https://developer.vippsmobilepay.com/) 获取与 API 相关的问题
* 联系 Vipps MobilePay 支持以处理账户和凭证问题

## 截图[​](#screenshots "直接链接到 截图")

截图将在未来的更新中添加，以显示：

* WooCommerce 支付设置中的网关配置
* 带有二维码和推送通知选项的 POS 结账界面
* 付款确认流程