本页内容
在 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 两种状态是否已配置。
先试收一笔
- 下载适用于 Joomla 的免费 ZIP。在 Joomla 后台进入 System → Install → Extensions,上传 ZIP。
- 打开 System → Manage → Plugins,启用 Payment - Paymos for HikaShop。随后进入 HikaShop 的 System → Payment methods,新建并保存 Paymos 付款方式。
- 点 Connect Paymos,选择店铺要用的 Paymos 项目并授权。先选 Sandbox 并保存付款方式,试单时再发布。Sandbox 测试不动用真实资金。
- 准备开始正式收款时,将模式切换到 Live,保存后发布。
试单时,先在店铺里选刚发布的付款方式。走完付款流程,再回后台打开这笔订单,核对付款结果。上线前,再核对一次项目和付款模式。
插件用 Joomla 安装密钥加密连接凭据。如果站点的规范网址变了,请重新连接项目。
在哪里看付款结果
插件按订单已保存的金额和币种开账单。收到通知后,它会核验签名,再用 API 核对付款。核实付足或多付后才确认订单,重复通知不会重复确认。付款金额不足,订单保持未确认。超时到账或付款信息不符,需要人工复核。如果店铺漏收了通知,可以打开订单,点 Check payment 查款。这一步由你在后台触发,无需配置定时任务。
想让买家付款后回到店铺,可在 Paymos 项目中设置 Success URL。在 Joomla 基础网址后加上 /index.php?option=com_hikashop&ctrl=checkout&task=after_end。买家返回店铺只代表跳转成功。发货前请查看订单状态。
在订单里申请或查询退款
启用退款功能后,符合条件的订单可以申请全额退款,也可以只退多付的款。服务器计算退款金额,收款地址用原付款的发送地址。退款待处理期间,订单状态保持原样。要看已有申请的进度,在订单里点 Check refund。
全额退款经核实后,订单转为 refunded。只退多付款,订单保留当时的状态,比如已发货或已送达。退款结果会记入订单历史。网络可能收取手续费。详见退款指南。
解除连接或卸载前,先处理完待办退款。点 Disconnect 或卸载插件会清除本地凭据,原有订单和订单历史仍留在 HikaShop。
许可证
插件采用 GPL-2.0-or-later 许可证,SDK 采用 MIT 许可证。