Plugins

WooCommerce 插件

在 WordPress + WooCommerce 商城里安装派付插件,填入应用密钥后,顾客结账时即可选择加密货币付款: 插件为订单创建派付付款单,顾客跳转到派付付款页完成支付,付款结果自动同步回商城订单。

准备

  • 已安装并启用 WooCommerce 的 WordPress 站点,站点使用 https。
  • 在派付管理后台创建应用,拿到 API Key 与 API Secret(Secret 只在创建时显示一次,请妥善保存)。
  • 插件安装包: 联系我们获取。

1. 安装

  1. 进入 WordPress 后台 → 插件 → 安装插件 → 上传插件。
  2. 选择派付插件 zip 包,点击「立即安装」。
  3. 安装完成后点击「启用插件」。

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 地址换成沙箱环境,并使用沙箱应用的密钥即可。