Plugins
WooCommerce 插件
在 WordPress + WooCommerce 商城里安装派付插件,填入应用密钥后,顾客结账时即可选择加密货币付款: 插件为订单创建派付付款单,顾客跳转到派付付款页完成支付,付款结果自动同步回商城订单。
准备
- 已安装并启用 WooCommerce 的 WordPress 站点,站点使用 https。
- 在派付管理后台创建应用,拿到 API Key 与 API Secret(Secret 只在创建时显示一次,请妥善保存)。
- 插件安装包: 联系我们获取。
1. 安装
- 进入 WordPress 后台 → 插件 → 安装插件 → 上传插件。
- 选择派付插件 zip 包,点击「立即安装」。
- 安装完成后点击「启用插件」。
2. 配置
进入 WooCommerce → 设置 → 付款,找到派付付款方式,启用后打开设置页填写:
- API Key / API Secret:填入派付后台应用的密钥。
- API 地址:派付开放 API 地址,正式环境为
https://api.pqpa.com;测试时可填沙箱环境地址。 - 付款方式名称与说明:顾客在结账页看到的文字,可按需修改。
商城币种限制
目前仅支持以 USD 或 CNY 计价的商城。订单按法币金额下单,付款时按实时汇率折算为加密货币。 商城币种不在支持范围内时,结账页不会显示派付付款方式。3. 回调地址
付款结果由派付通过回调通知你的商城。插件设置页会显示本站的回调地址(形如 https://你的域名/...),请把它填到派付后台该应用的回调地址配置中。
- 回调地址必须能从公网访问,并使用 https。
- 插件会校验回调签名,签名不通过的请求会被拒绝。
- 若站点使用了防火墙、CDN 或安全插件,请放行该回调地址。
4. 订单状态同步规则
| 派付付款单状态 | WooCommerce 订单状态 |
|---|---|
| 已付款 | 处理中(Processing) |
| 部分支付 | 保持原状态,不自动变更,由商家核对后处理 |
| 已过期 | 已取消(Cancelled) |
常见问题
结账页看不到派付付款方式?
检查插件是否已启用、付款方式是否已打开,以及商城币种是否为 USD 或 CNY。
顾客已付款,订单却没有变成「处理中」?
通常是回调没有送达:确认派付后台填写的回调地址正确、站点可从公网访问且未被防火墙拦截。 可在派付后台查看该笔回调的投递记录并重发。
顾客少付了怎么办?
部分支付的订单不会自动发货,订单保持原状态,请在派付后台核对实收金额后与顾客沟通补款或退款。
可以先在测试环境试用吗?
可以。把 API 地址换成沙箱环境,并使用沙箱应用的密钥即可。