# 在 HikaShop 接入 Paymos 收款

> 在 Joomla 安装 Paymos 付款插件，绑定收款项目，再用 HikaShop 订单核对付款和退款。

买家在 HikaShop 下单，到 Paymos 付款页付款。付款结果、退款记录和订单历史都可以在 HikaShop 后台查看。

## 安装前核对版本和订单状态

Joomla 须为 5.4 或 6.2。HikaShop 须为 6.8 系列的 6.8.1 或更新版本。使用 PHP 8.3 或更高版本，并启用 cURL 和 OpenSSL。店铺要能从公网通过 HTTPS 访问。订单、订单历史、商品、订单商品、折扣和用户表都要使用 InnoDB。在 HikaShop 中，将新建订单状态（**Order created status**）设为 `created`，并检查 `confirmed` 和 `refunded` 两种状态是否已配置。

## 先试收一笔

1. 下载[适用于 Joomla 的免费 ZIP](https://github.com/Paymos-labs/hikashop/releases/latest)。在 Joomla 后台进入 **System → Install → Extensions**，上传 ZIP。
2. 打开 **System → Manage → Plugins**，启用 **Payment - Paymos for HikaShop**。随后进入 HikaShop 的 **System → Payment methods**，新建并保存 Paymos 付款方式。
3. 点 **Connect Paymos**，选择店铺要用的 Paymos 项目并授权。先选 **Sandbox** 并保存付款方式，试单时再发布。Sandbox 测试不动用真实资金。
4. 准备开始正式收款时，将模式切换到 **Live**，保存后发布。

试单时，先在店铺里选刚发布的付款方式。走完付款流程，再回后台打开这笔订单，核对付款结果。上线前，再核对一次项目和付款模式。

插件用 Joomla 安装密钥加密连接凭据。如果站点的规范网址变了，请重新连接项目。

## 在哪里看付款结果

插件按订单已保存的金额和币种开账单。收到通知后，它会核验签名，再用 API 核对付款。核实付足或多付后才确认订单，重复通知不会重复确认。付款金额不足，订单保持未确认。超时到账或付款信息不符，需要人工复核。如果店铺漏收了通知，可以打开订单，点 **Check payment** 查款。这一步由你在后台触发，无需配置定时任务。

想让买家付款后回到店铺，可在 Paymos 项目中设置 **Success URL**。在 Joomla 基础网址后加上 `/index.php?option=com_hikashop&ctrl=checkout&task=after_end`。买家返回店铺只代表跳转成功。发货前请查看订单状态。

## 在订单里申请或查询退款

启用退款功能后，符合条件的订单可以申请全额退款，也可以只退多付的款。服务器计算退款金额，收款地址用原付款的发送地址。退款待处理期间，订单状态保持原样。要看已有申请的进度，在订单里点 **Check refund**。

全额退款经核实后，订单转为 `refunded`。只退多付款，订单保留当时的状态，比如已发货或已送达。退款结果会记入订单历史。网络可能收取手续费。详见[退款指南](/zh-hans/docs/support/refunds.md)。

解除连接或卸载前，先处理完待办退款。点 **Disconnect** 或卸载插件会清除本地凭据，原有订单和订单历史仍留在 HikaShop。

## 许可证

插件采用 [GPL-2.0-or-later 许可证](https://github.com/Paymos-labs/hikashop/blob/main/LICENSE)，SDK 采用 MIT 许可证。
