YMX 主题内置了一套完整的「会员交易」系统,站长只需在后台把支付参数填好,就能实现 VIP 会员售卖、付费阅读等内容变现。本文手把手说明支付相关功能的配置方法。
一、配置入口在哪
登录 WordPress 后台,依次进入:
外观 → 主题设置 → 会员交易
进入后,左侧会列出「会员交易」板块下的所有子菜单。与支付直接相关的有 4 个:
| 子菜单 | 作用 |
|---|---|
| 微信支付设置 | 配置微信扫码 / H5 / App 支付 |
| 支付宝设置 | 配置支付宝电脑网站 / 手机网站支付 |
| 积分支付设置 | 开启积分抵扣并设置兑换比例 |
| 代币支付设置 | 开启代币支付、自定义名称与兑换比例 |
此外还有「VIP会员设置」「积分设置」等,用来设定「卖什么、多少钱」以及积分从哪来,本文一并说明。
YMX 支持的四种支付方式:微信支付、支付宝、积分、代币。VIP 会员可免费阅读付费内容(具体以「VIP会员设置」为准)。
二、第一步:配置微信支付
进入「会员交易 → 微信支付设置」,页面顶部会有一个「申请说明」折叠框,自动按你当前域名生成回调地址。需要填写以下字段:
| 后台字段 | 填什么 | 来源 |
|---|---|---|
| 微信支付开关 | 勾选启用 | — |
| 商户号 | 微信支付商户号 mch_id | 微信商户平台 → 账户中心 → 商户信息 |
| API密钥 | 32 位 API v2 密钥 | 微信商户平台 → 账户中心 → API安全 |
| 证书路径 | apiclient_cert.pem 的服务器绝对路径 | API安全下载 |
| 密钥路径 | apiclient_key.pem 的服务器绝对路径 | API安全下载 |
| 公众号APPID | 已认证微信服务号的 APPID | 微信公众平台 |
注意:
- 本主题基于
yansongda/payv2,使用微信支付 API v2,密钥是 32 位 v2 密钥,不是 APIv3 密钥,两者不要搞混。 - 商户号必须与所填公众号 APPID 完成关联,否则下单会报错。
- 「证书路径 / 密钥路径」要填服务器绝对路径,例如
/www/wwwroot/example.com/cert/apiclient_cert.pem,证书建议放在站点根目录之外、无法通过浏览器直接访问的位置。 - 支付金额单位为「分」,主题会自动换算,无需额外处理。
三、第二步:配置支付宝
进入「会员交易 → 支付宝设置」,填写:
| 后台字段 | 填什么 | 来源 |
|---|---|---|
| 支付宝开关 | 勾选启用 | — |
| 应用ID | 应用 APPID | 支付宝开放平台 → 应用详情 |
| 应用私钥 | 你自己生成的 RSA2 应用私钥 | 密钥生成工具 |
| 支付宝公钥 | 支付宝平台返回的公钥 | 上传应用公钥后平台返回 |
注意:
- 需要在支付宝开放平台为应用签约产品:「电脑网站支付」对应电脑端,「手机网站支付」对应手机网页,且要审核通过才能发起真实支付。
- 密钥使用 RSA2(SHA256) 格式,生成时选「RSA2」。
- 「支付宝公钥」填的是支付宝侧返回的公钥,不是你自己生成的应用公钥——填错会导致验签失败、订单不回调。
- 「应用私钥」在数据库中加密存储,后台显示为密码框,请妥善保管原值。
四、第三步:配置积分支付
进入「会员交易 → 积分支付设置」:
| 后台字段 | 说明 |
|---|---|
| 积分支付开关 | 勾选后,用户可用积分抵扣订单 |
| 积分兑换比例 | 多少积分等于 1 元,默认 1 |
例如设为 100,那么一个 30 元的月卡就需要 30 × 100 = 3000 积分。
积分支付依赖「会员交易 → 积分设置」里的「积分功能开关」以及积分获取规则,见下文第六步。
五、第四步:配置代币支付
进入「会员交易 → 代币支付设置」:
| 后台字段 | 说明 |
|---|---|
| 代币支付开关 | 勾选后,用户可用代币支付 |
| 代币名称 | 自定义代币名称,如「金币」「D币」,默认「代币」 |
| 代币兑换比例 | 多少代币等于 1 元,默认 1 |
| 新用户赠送 | 新用户注册自动赠送的代币数量,默认 0 |
代币与积分相互独立,可以分别定价、分别赠送,用于不同的运营玩法。
六、卖什么:VIP 会员价格设置
支付方式配好之后,还要设定「卖什么」。进入「会员交易 → VIP会员设置」:
| 关键字段 | 默认值 | 说明 |
|---|---|---|
| VIP功能开关 | 关 | 打开后 VIP 功能才生效 |
| VIP名称 | VIP | 可自定义,如「会员」「黄金会员」 |
| 体验卡价格(1天) | 5.00 | 单位:元 |
| 月卡价格 | 30.00 | 单位:元 |
| 季卡价格 | 80.00 | 单位:元 |
| 年卡价格 | 280.00 | 单位:元 |
| 终身卡价格 | 999.00 | 单位:元 |
此外还可以设置各套餐「每日下载和阅读次数」、是否给 VIP 去除广告、是否直接阅读回复可见内容、自动把某价格区间的付费内容标记为 VIP 资源、邀请码兑换、权益说明文案等。
七、积分从哪来:积分设置
积分支付能用起来的前提是用户手里有积分。进入「会员交易 → 积分设置」,打开「积分功能开关」,并配置积分获取规则:
- 签到送积分(默认 10)
- 连续签到额外奖励(默认 5)
- 点赞 / 收藏 / 评论送积分
- 评论审核通过送积分
- 订单送积分倍数(订单金额 × 倍数 = 赠送积分)
- 绑定账号、上传头像、认证送积分
用户通过这些行为积累积分,再用积分抵扣付费内容或 VIP,形成站内闭环。
八、回调地址汇总
支付回调地址由程序在下单时自动携带,通常无需逐单填写,但要在对应平台核对域名/授权目录一致:
| 支付方式 | 用途 | 地址 |
|---|---|---|
| 微信支付 | 异步通知 | {站点地址}/wp-admin/admin-ajax.php?action=ymx_pay_notify_wechat |
| 支付宝 | 异步通知 | {站点地址}/wp-admin/admin-ajax.php?action=ymx_pay_notify_alipay |
| 支付宝 | 同步回跳 | {站点地址}/wp-admin/admin-ajax.php?action=ymx_pay_return |
其中 {站点地址} 替换为你的真实站点地址。微信商户平台需配置支付授权目录(如 https://你的域名/),支付宝部分老版本开放平台需在「开发设置」配置默认授权回调地址。
九、常见问题与注意事项
- 为什么支付后订单状态不变? 先检查密钥是否正确(微信用 v2 密钥、支付宝用支付宝公钥),再确认服务器能访问外网、回调域名与平台配置一致。
- 微信提示「签名错误」? 大概率是 API 密钥填成了 v3 密钥,或商户号与 APPID 未关联。
- 支付宝提示「产品未开通」? 应用未签约「电脑网站支付 / 手机网站支付」,或签约未审核通过。
- 密钥安全:所有密钥类参数(AppSecret、API 密钥、应用私钥等)均为加密存储,后台为密码框,请妥善保管原值。
- 备案要求:微信、支付宝等国内平台均要求站点使用已备案的公网域名,
localhost、内网 IP 或未备案域名无法正常回调。
十、配置完成后的自测建议
- 先用一个测试账号,登录状态下完整走一遍「下单 → 支付 → 回调 → 到账/VIP 生效」。
- 分别测试微信、支付宝、积分、代币四种方式(至少各一笔小额订单)。
- 检查后台「YMX会员管理 → 订单管理」中订单状态是否变为已支付、VIP 是否正常开通。
- 确认无误后,再对外正式开放。
发表评论