# 在 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 的付款页。按[沙盒指南](/zh-hans/docs/testing.md)模拟付款。然后回到 GiveWP，找到刚才的捐款记录并查看状态。测试捐款完成后，在同一设置页面选择 **Live**，重新完成连接和确认。等 GiveWP 中的 **Live** 显示 **Connected** 后，再关闭 GiveWP 的测试模式。

## 付款状态和收据

创建账单时，插件会发送金额、币种、项目和内部编号。收到 webhook 后，插件会验证 HMAC 签名，并通过 API 核对项目、账单、金额和币种。WordPress 也会按计划复查尚待处理的记录。

插件核实款项已足额到账后，才会在 GiveWP 将捐款标记为已完成，并向捐款人提供 GiveWP 的收据。如果捐款人支付的金额超过账单金额，这笔捐款也会标记为已完成。同一笔捐款只会完成一次。遇到部分付款或逾期到账时，打开捐款记录人工核查，再决定如何处理。

## 退款

有退款权限的人员可以打开 **GiveWP → Paymos refunds**，查看这笔捐款是否符合全额退款或退回多付款项的条件。Paymos 会将款项退回原付款记录中的发送地址。全额退款完成后，GiveWP 会将捐款标记为已退款。如果只退回多付的部分，捐款仍显示为已完成。具体步骤见[退款指南](/zh-hans/docs/support/refunds.md)。

## 停用或卸载插件

停用插件后，WordPress 会停止插件安排的定时检查。卸载插件会清除保存在网站上的连接凭据，浏览器也无法再打开付款状态页。历史捐款记录仍可在 GiveWP 查看。网站只保留人工跟进所需的未结记录编号。需要协助核查捐款时，可[联系 Paymos 支持](mailto:support@paymos.io)。
