本页内容
在 GiveWP 接收稳定币捐款
将 Paymos 接入 GiveWP,先在沙盒测试捐款,再核对付款状态和收据,确认测试通过后切换到正式环境。
Paymos Stablecoin Donations 让捐款人通过 GiveWP 表单用稳定币完成单次捐款。插件适用于 GiveWP 可视化编辑器创建的表单,也适用于经典表单。捐款人付款后,可以在 GiveWP 打开这笔捐款的记录,查看款项是否已确认,或判断是否需要人工跟进。
安装要求
WordPress 至少需要 6.9 版,GiveWP 至少需要 4.19.1.1 版,PHP 至少需要 7.4 版。安装前,检查服务器能否使用 OpenSSL,并确认网站通过 HTTPS 访问。插件公开发布后,可从 Paymos 控制台或 GitHub 的发布页面下载 paymos-givewp.zip。
安装插件并连接 Paymos
先确认 GiveWP 已启用。在 WordPress 后台打开 Plugins → Add New Plugin → Upload Plugin,上传 ZIP 文件并启用插件。
进入 GiveWP → Settings → Payment Gateways → Paymos,选择 Sandbox,并在 GiveWP 打开测试模式,让两边处于同一环境。在 Paymos 控制台打开要连接的项目。回到 WordPress 的 GiveWP 支付设置,点击 Connect Paymos。页面显示验证码和 Open Paymos 按钮后,点击 Open Paymos。在 Paymos 的确认页面核对网站地址和当前显示的项目,将验证码与 WordPress 显示的验证码比对,然后批准连接。回到 GiveWP,等 Sandbox 显示 Connected 后,再在要测试的表单中启用 Paymos。
在沙盒测试捐款
像捐款人一样填写并提交表单。表单会先打开网站上的付款状态页,再从状态页进入 Paymos 的付款页。按沙盒指南模拟付款。然后回到 GiveWP,找到刚才的捐款记录并查看状态。测试捐款完成后,在同一设置页面选择 Live,重新完成连接和确认。等 GiveWP 中的 Live 显示 Connected 后,再关闭 GiveWP 的测试模式。
付款状态和收据
创建账单时,插件会发送金额、币种、项目和内部编号。收到 webhook 后,插件会验证 HMAC 签名,并通过 API 核对项目、账单、金额和币种。WordPress 也会按计划复查尚待处理的记录。
插件核实款项已足额到账后,才会在 GiveWP 将捐款标记为已完成,并向捐款人提供 GiveWP 的收据。如果捐款人支付的金额超过账单金额,这笔捐款也会标记为已完成。同一笔捐款只会完成一次。遇到部分付款或逾期到账时,打开捐款记录人工核查,再决定如何处理。
退款
有退款权限的人员可以打开 GiveWP → Paymos refunds,查看这笔捐款是否符合全额退款或退回多付款项的条件。Paymos 会将款项退回原付款记录中的发送地址。全额退款完成后,GiveWP 会将捐款标记为已退款。如果只退回多付的部分,捐款仍显示为已完成。具体步骤见退款指南。
停用或卸载插件
停用插件后,WordPress 会停止插件安排的定时检查。卸载插件会清除保存在网站上的连接凭据,浏览器也无法再打开付款状态页。历史捐款记录仍可在 GiveWP 查看。网站只保留人工跟进所需的未结记录编号。需要协助核查捐款时,可联系 Paymos 支持。