接入现有商店
沿用 Commerce 的订单流程
模块核验付款并将结果交给 Commerce。商店根据自身规则决定何时交付商品。
Commerce 原生支付方式
将 Paymos 加入商店的支付方式列表。模块使用 Commerce 的订单和支付记录,适用于 Drupal 10.3 或 11,以及 Commerce 3。
先核验,再更新状态
签名 webhook 触发 API 核验,逐项检查订单、项目、环境、金额和币种。Drupal cron 会继续未完成的检查;买家返回商店并不代表付款成功。
由管理员发起退款
满足条件时,管理员可发起全额退款或退还多付款。服务器计算金额,以首次保存的付款发送方为收款人。退款会产生新的转出交易及网络手续费。
先用 Sandbox 测试
连接一次即可获得 Sandbox 和 Live 两个环境。在 Commerce 支付网关中选择环境,先用 Sandbox 检查订单流程;测试不会转移真实资金。
安装与连接
在 Drupal 内连接项目
先安装模块,再确认 Paymos 项目,最后创建支付网关并选择环境。
安装模块
通过 Drupal.org 的 Composer 包安装,或下载 GitHub 公开 ZIP,其中已包含 SDK。随后在 Drupal 启用模块。安装包不含商店密钥。
确认项目连接
在 Paymos 打开要连接的项目,再进入 Drupal 的 /admin/commerce/config/payment/paymos。点击 Connect Paymos,确认显示的商店和当前项目,无需手动填写密钥。
创建支付网关
在 /admin/commerce/config/payment-gateways/add 创建 Paymos 网关。测试时选择 Sandbox,收取真实付款时选择 Live;两个环境来自同一次连接。
官方安装包
下载并连接项目
选择商店平台对应的安装包,按指南完成设置。安装前先核对版本兼容性。
官方版本下载
下载公开安装包,并在 GitHub 查看更新说明和历史版本。
平台目录中的插件页面
若插件已在平台目录发布,可打开对应页面,查看安装包信息和安装方式。
安装与连接指南
核对平台要求,连接 Paymos 项目,再按指南测试商店的付款流程。