收款与订单
进入 主题设置 → 支付配置。资源购买与 VIP 购买共用同一套支付能力。建议先完成一条可用通道的验证,再增加其他支付方式。
配置结构
主题将支付拆分为三层,请勿将前台入口与实际对接平台混为一谈:
- 支付方式:前台支付弹窗中的入口,例如支付宝、微信、QQ 或其他方式。每个入口下可配置多条支付通道,支持启用、停用与排序。
- 支付服务商:实际处理请求的平台,例如易支付、V免签、PayJS。
- 全局设置:订单超时、支付日志与测试模式。
前台仅展示已启用、参数完整且服务商可用的通道。排序越靠前,弹窗中越优先显示。
配置步骤
- 进入
支付配置 → 服务商,选择服务商,填写商户号、密钥、网关等必填项并保存。 - 切换至「支付方式」,启用对应通道,必要时修改显示名称。
- 在「全局设置」中确认订单超时时间,默认 5 分钟。
- 使用低价测试资源完成一笔订单,核验:发起支付 → 完成付款 → 异步通知到达 → 订单变为已支付 → 资源或 VIP 即时生效。
建议先验证 1 个服务商与 1 条通道,再接入其余服务商。
支持的服务商
以后台「服务商」列表为准,当前包括:
- 易支付(EPay):可承载支付宝、微信、QQ
- V免签
- PayJS
- 虎皮椒
- 迅虎支付
- XorPay
- 支付宝官方
- 微信官方支付
- PayPal:适用于海外或美元订单
各服务商所需字段不同,请按表单提示填写。易支付不支持笼统的「其他」方式,须明确选择支付宝、微信或 QQ。
通知与返回地址
支付平台通常要求两类地址:
- 异步通知:平台向站点告知支付结果,用于将订单更新为已支付
- 同步返回:用户完成支付后跳回站点,用于展示结果并继续流程
请将下列路径与站点域名组合使用。主题按服务商选用对应地址:
| 用途 | 路径 |
|---|---|
| 通用通知 / 返回 | /payment/notify/ 、 /payment/return/ |
| V免签通知 | /payment/vmq/notify/ |
| PayJS 通知 | /payment/payjs/notify/ |
| 虎皮椒 / 迅虎通知 | /payment/xunhu/notify/ |
| XorPay 通知 | /payment/xorpay/notify/ |
| 支付宝官方通知 / 返回 | /payment/alipay/notify/ 、 /payment/alipay/return/ |
| 微信支付官方通知 | /payment/wxpay/notify/ |
| PayPal 返回 | /payment/paypal/return/ |
上述地址必须可被支付平台从公网访问。请勿对其启用登录限制、验证码、防盗链或静态缓存。防火墙、CDN 或安全插件若拦截 /payment/,将表现为用户已付款、站点仍显示待支付。
生产环境须使用 HTTPS。服务商后台填写的地址须与站点实际域名一致,包括是否带有 www 以及尾斜杠,请按平台要求与主题示例对齐。
全局支付选项
- 订单超时:未支付订单的有效分钟数;超时后须重新下单
- 支付日志:记录创建、回调、签名校验与异常;排查问题时建议启用
- 测试模式:部分服务商提供测试环境;正式对外前须关闭
修改后请重新打开前台支付弹窗,确认通道仍可用。
支付与履约流程
- 用户在资源详情页或 VIP 页面发起购买
- 主题创建订单,并生成二维码或跳转地址
- 用户完成付款,平台向站点发送异步通知
- 站点校验签名、金额与订单号
- 校验通过后更新订单:资源订单解锁下载 / 在线查看;VIP 订单完成开通、续费或升级
创建订单时将保存当时的资源交付快照。此后修改文章链接或图集,不会覆盖已成交订单的交付内容。
订单列表
进入 主题设置 → 订单列表。
可查看今日、近 7 日、本月与累计收入,并按状态、时间、订单号、用户、邮箱或文章标题筛选。VIP 订单与资源订单列于同一列表,VIP 订单号通常以 VIP 开头。
前台状态说明见 用户中心。后台处理时请重点关注:
- 待支付:尚未收到有效付款
- 已支付:款项与权益均已完成
- 已收款,权益发放失败:款项已入账,但资源权限或 VIP 未能自动开通,须人工处理
- 已退款 / 已取消 / 支付失败
请勿要求用户对「已收款,权益发放失败」的订单重复支付。应先核查支付日志,以及文章或套餐是否仍可交付,再进行人工处理。
下载记录
进入 主题设置 → 下载记录。
用于记录购买后的下载,以及仅会员资源的获取行为。可按用户、文章、时间筛选,亦可批量删除或清理过期记录。
下载记录是客服核验与风控依据,不建议频繁清空。数据库压力较大时,可按 90 天或 180 天归档清理。仅会员资源的每日额度将参考这些记录,清理前请明确统计口径。
故障排查
支付弹窗未显示任何支付方式
服务商参数不完整,或通道未启用、关联服务商已停用。保存后清除缓存,再打开资源详情页或 VIP 页面核验。
用户已付款,订单仍为待支付
异步通知未到达,或到达后未通过校验。请核对服务商后台的通知地址、密钥与金额,以及 CDN / 防火墙是否拦截 /payment/,并对照支付日志中的时间点。
款项已入账,资源未解锁
请确认订单是否为「已收款,权益发放失败」,并核验文章是否仍为资源商品、下载链接或在线图库是否完整。交付不完整的资源将停售;历史订单仍按自身快照判断能否继续交付。
VIP 已付款,会员未开通
同样先核查履约状态,再确认套餐仍然存在、未被停用,且价格与等级未在付款过程中被修改。可在 VIP 会员 → VIP 用户 中核对并手动修正。