Vipps MobilePay 网关
Vipps MobilePay 网关允许您在 WCPOS 中直接接受基于电话的支付。客户可以通过扫描屏幕上的二维码或在他们的手机上确认推送通知进行付款，无需卡读设备。
功能
二维码支付
在结账时显示二维码，供客户扫描并使用手机支付
推送通知
通过输入客户的号码直接向客户的手机发送付款请求
北欧覆盖
在挪威使用 Vipps，在丹麦和芬兰使用 MobilePay
自动捕获
在授权后立即捕获资金，或保留以便手动捕获
安装
下载并安装
- 访问 WCPOS Vipps MobilePay 发布页面
- 下载最新的 wcpos-vipps.zip 文件
- 在您的 WordPress 管理中，转到
插件 > 添加新 > 上传插件 - 上传 zip 文件并激活插件
配置 Vipps 证书
- 导航到
WP Admin > WooCommerce > 设置 > 支付 - 在支付方式列表中找到 WCPOS Vipps MobilePay
- 点击 WCPOS Vipps MobilePay 进入设置
- 输入您在 Vipps 门户 中的证书：
- 商户序列号 (MSN)
- 客户端 ID
- 客户端密钥
- 订阅键
- 保存设置
您不需要在这里为 POS 使用启用网关 — 它将在下一步中专门为 POS 启用。在 WooCommerce 设置中启用它也会使其在您的在线商店结账时可用，这对于测试可能很有用。
如果您安装了官方的 使用 Vipps MobilePay 结账 插件，则在激活此插件时，您的凭证将自动导入。您可以跳过手动输入凭证的步骤。
在 WCPOS 中启用
- 转到
WP Admin > POS > 设置 > 结账 - 在列表中找到 WCPOS Vipps MobilePay 网关
- 启用该网关以供 POS 使用
- 保存您的设置
使用方法
处理支付 — 二维码
- 添加项目：在 POS 中将产品添加到购物车
- 选择网关：选择“Vipps MobilePay”作为支付方式
- 生成二维码：点击“生成二维码”按钮
- 客户扫描：客户使用他们的 Vipps 或 MobilePay 应用扫描二维码
- 客户确认：客户在他们的应用中确认付款
- 自动完成：一旦付款获得授权，订单将自动完成
处理支付 — 发送到手机
- 添加项目：在 POS 中将产品添加到购物车
- 选择网关：选择“Vipps MobilePay”作为支付方式
- 输入电话号码：输入客户的电话号码
- 发送到手机：点击“发送到手机”按钮
- 客户确认：客户收到推送通知或被引导到 Vipps 登陆页面，然后在他们的应用中确认付款
- 自动完成：一旦付款获得授权，订单将自动完成
该插件会自动检测将付款请求发送到客户手机的最佳方法：
- 直接推送（首选） — 直接向客户的 Vipps 应用发送通知。这是最快的体验，但需要 Vipps 在您的销售单位上启用
PUSH_MESSAGE（见下文 启用直接推送）。 - 登陆页面后备 — 如果未启用直接推送，插件将在新浏览器选项卡中打开 Vipps 登陆页面。登陆页面处理发送通知。这在没有特殊批准的情况下立即可用。
第一次插件检测到直接推送不可用时，您会看到一条简短消息，提示您再次点击“发送到手机”。之后，它会记住结果并无缝工作。
启用直接推送
直接推送流程为电话支付提供了最佳体验 — 无需额外选项卡，无需登陆页面。要启用它：
- 登录到 portal.vippsmobilepay.com
- 联系您的 Vipps 关键客户经理、合作经理或客户服务
- 告诉他们：“我需要在我的 MSN 上启用 PUSH_MESSAGE，以用于 POS 集成”
一旦获得批准，插件将在 24 小时内自动检测到更改并切换到直接推送流程。使用登陆页面后备时，您将在网关设置页面上看到提醒通知。
取消付款
在等待客户确认期间，您可以点击 取消付款 按钮以中止交易。这将在 Vipps 端取消待处理的付款并重置结账界面。
退款
退款通过标准的 WooCommerce 退款流程处理。打开订单，点击 退款，输入金额，退款将通过 Vipps API 自动处理。
支持的市场
Vipps MobilePay 在北欧地区以两个品牌运营：
| 地区 | 品牌 | 货币 |
|---|---|---|
| 挪威 | Vipps | NOK |
| 丹麦，芬兰 | MobilePay | DKK，EUR |
您的商户账户决定可用的市场和货币。在任何支持的市场中，客户均可使用他们本地的 Vipps 或 MobilePay 应用进行支付。
资格要求
故障排除
常见问题
付款未完成
- 结账最多会轮询 5 分钟 — 如果客户在此窗口内未确认，付款将超时
- 检查您是否混淆了测试模式和生产凭证
- 验证 POS 设备和客户手机的互联网连接是否稳定
无效凭证错误
- 检查所有四个凭证字段（MSN、客户端 ID、客户端密钥、订阅键）
- 确保在启用测试模式时使用测试凭证，在禁用时使用生产凭证
- 在 Vipps 门户 中验证您的凭证
‘发送到手机’打开新选项卡而不是直接发送
这意味着您的 Vipps 账户尚未启用 PUSH_MESSAGE。该插件正在使用登陆页面后备方案，这虽然有效，但增加了一步。要获得更顺畅的直接推送体验，请联系 Vipps 并要求他们在您的销售单位（MSN）上启用 PUSH_MESSAGE。参见上面的 启用直接推送。
二维码未生成
- 确认您的网站通过 HTTPS 运行 — Vipps API 拒绝来自 HTTP 网站的请求
- 检查 WooCommerce 日志 (
WooCommerce > 状态 > 日志) 以获取 API 错误详细信息 - 验证您的商户账户是否活跃，并且启用了电子支付 API
获取帮助
对于技术支持：
- 访问 GitHub 仓库 报告问题
- 检查 Vipps 开发者文档 获取与 API 相关的问题
- 联系 Vipps MobilePay 支持以处理账户和凭证问题
截图
截图将在未来的更新中添加，以显示：
- WooCommerce 支付设置中的网关配置
- 带有二维码和推送通知选项的 POS 结账界面
- 付款确认流程