YuPay 常见问题

为什么强调无中间商？

YuPay 的设计是服主直接对接自己的微信支付、支付宝官方商户号。资金不经过第三方代收平台，插件只负责在服务器内创建订单、处理回调、发放奖励和记录数据。

费率是多少？

常见官方通道费率为 0.2%-0.6%。如果你需要永久 0.2% 费率，请联系作者处理商户通道方案。

支付成功但没有发奖励怎么办？

先执行 /yp health 检查支付渠道、数据库和依赖状态，再查看订单历史与奖励日志。若奖励命令依赖 Vault、PlayerPoints 或跨服队列，请确认对应软依赖已正常加载。

回调失败怎么排查？

确认 notify-url 使用公网可访问的 HTTP/HTTPS 地址，服务器防火墙已放行端口，反向代理没有拦截支付平台 POST 请求。微信支付还需要确认 API v3 密钥、商户私钥、平台公钥和证书序列号匹配。

退款需要管理员审核吗？

玩家可提交退款申请，管理员可以通过 /yp refund approve <请求ID> 或 /yp refund reject <请求ID> 审核；也可以使用带 -f 的直接退款命令处理特殊情况。

可以给其他插件调用吗？

可以。建议在 api.allowed-plugins 中按插件名授权，只给可信插件开放创建订单、取消订单和查询订单等必要能力；退款与绕过奖励能力默认保持关闭。