MERCHANT DEVELOPERS

WP插件 · 安装文档

WordPress / WooCommerce 支付插件的安装、商户配置、固定汇率、订单状态与验收说明。

文档 2.9 · 2026-10-21WooCommerce 支付插件 · 安装与配置
下载 PDF(与在线文档同步)

没有匹配内容,请尝试其他关键词。

WOOCOMMERCEWordPress / WooCommerce 支付插件

下载 WooCommerce 支付插件 ZIP 版本 1.0.0。支持普通通道、USDT 主网与测试网、经典结账、新版区块结账、HPOS 订单存储。插件界面支持中文和英文;下载包不包含商户密钥。

  1. WordPress 后台 → 插件 → 安装插件 → 上传 ZIP 并启用;先安装并启用 WooCommerce。
  2. WooCommerce → 设置 → 付款 → VNPAYMENT:填写商户登录账号、商户签名密钥、通道编号;接口网关填 https://payment.271458.xyz/。回调地址由插件自动生成,商店必须公网 HTTPS 可达。
  3. 普通通道填写平台约定的收款币种,必须与商店币种相同,不自动换汇。数字货币填写商店币种代码及固定汇率:1 USDT = N 商店币种,例如 CNY、7,7 元订单收 1.00 USDT。美元等币种按相同规则配置;USDT 商店使用 1:1。
  4. 一次配置一个通道:主网 2901 / 2902 / 2903;测试网 2911 / 2912 / 2913,分别对应 Ethereum、TRON、BSC。修改配置只影响新订单。平台需先启用商户通道、可用钱包,并备足对应环境的 USDT 服务费余额;无需设置数字货币自定义费率。
固定汇率与平台手续费分开:应付 USDT = 商店订单总额 ÷ 插件固定汇率,四舍五入到两位。插件锁定每笔订单的原金额、币种及汇率;平台不执行汇率换算,商户 USDT 服务费余额按统一阶梯规则扣费。商店总额目前仅支持精确到两位小数,换算结果不足 0.01 USDT 会拒绝下单;不提供自动汇率服务。
阶段WooCommerce 行为
下单成功保留待付款;显示应付金额、固定汇率与平台付款页/二维码链接。商户订单号和平台订单号可在 WooCommerce 订单详情核对;平台后台也能看到该笔下单。
数字货币 confirming显示已检测到付款,等待最终确认;订单进入保留/on-hold。
confirmed / 普通通道 success验签、核对订单字段,并查询平台确认成功后调用 payment_complete;依商品类型进入处理中或已完成。浏览器跳转不能直接确认付款。
expired取消未付款订单;后续平台人工补单成功且查询核验通过,可恢复付款。
人工测试回调v2 签名 reason=test_callback 只写订单备注,不改付款状态。v1 成功通知同样必须通过平台查询核验,人工测试通知不能绕过真实订单状态。

测试网订单默认保持 on-hold,不自动标记已付款;仅在独立测试店铺开启“允许测试网订单标记已付款”,用于验证完整订单及库存流程。该开关不会让人工测试回调触发发货。测试网只转指定测试 USDT;共享钱包占用时查询已有订单或等到期,更换单号/金额不能解除占用。

通知按原字段验签、持久化、事件去重并按订单加锁;按序号处理,晚到旧通知不回退状态。付款状态应用失败保留重试任务。后台订单操作支持“查询并核验付款”。配置服务器每分钟执行 WordPress 到期 cron;自动补查每批最多十笔,正常两分钟一次、失败五分钟后重试,待付/确认中订单最多自动补查七天。低访问量站点需配置系统 cron;客户页面仅查询本地状态。

安装要求:64 位 PHP 8.1+、WordPress 6.6+、WooCommerce 9.0+、InnoDB 和数据库 advisory lock 支持。当前实测版本为 WordPress 7.1.3、WooCommerce 11.2.1、PHP 8.3;其他版本请先在测试站验收。插件不含自动退款、订阅扣款或 RSA 加密;不保管链上私钥。更换商户账号前先处理完旧订单。

验收顺序:独立测试店铺配置 → 测试通道下单 → 查询平台对应订单 → 测试 USDT 付款 → 确认中通知 → 最终通知及查询核验 → 重复/乱序通知检查 → 查看 WooCommerce 和平台后台。人工测试回调仅验连接、签名与订单备注,不能代替真实付款。完整安装与维护说明也包含在 ZIP 的 readme.txt 中。