为什么我的商店显示“不可用”或无法进行身份验证？
如果登录失败，通常情况下，当您的服务器返回 5xx 错误时，玩家会看到 “哎呀！” / “您似乎无法访问商店”。最常见的原因是您的 Players Auth webhook (playersAuthWebhook) 存在问题：无法访问、响应缓慢（>10 秒）、返回错误，或由于签名/密钥错误或响应无效而拒绝请求。 |
身份验证的工作原理
登录时，Appcharge 会根据您的集成设置，使用带签名或加密的负载向您的 Players Auth webhook 发送 POST 请求。您的端点必须返回
status: "valid" 以及字符串类型的 publisherPlayerId。如果该调用因任何原因失败，登录也会失败。检查事项
- 可访问性 — URL 可从公共互联网访问。
- 服务器日志 — 检查故障发生时间附近是否存在错误、超时或 4xx/5xx。
- SSL — 证书有效且未过期。
- 环境 — 在 设置 → 集成 中，Players Auth webhook URL 是否与正确的环境（沙盒环境还是生产环境）匹配。
- 密钥和签名 — 控制面板中的 Primary Key 是否与服务器用于验证请求的密钥匹配。
-
响应格式 — 成功响应应返回
status: "valid"+publisherPlayerId。 - 其他原因 — 玩家被屏蔽、地理位置限制、维护模式或身份验证方法配置错误。
测试您的端点
使用控制面板中的 集成测试工具 — 不带正确签名的普通 HTTP 调用无法匹配 Appcharge 调用您时的方式。请确认该 URL 可从您的网络外部访问。
联系支持团队
如果您的端点运行正常，但身份验证仍然失败，请联系 Appcharge 支持团队，并提供您的 Publisher ID、 身份验证方法、 故障时间、 webhook URL、 环境、日志中的任何 HTTP 错误，以及 集成测试 是否通过。