先确认问题停在哪一步
按「显示支付入口 → 创建订单 → 完成付款 → 确认订单 → 交付内容」的顺序检查。先找出最后一个正常完成的步骤,再排查下一步。
准备订单号、发生时间、买家访问的前端网址、币种、支付渠道、浏览器和登录状态。查看或修改渠道配置,需要使用能进入并保存瓜奇「支付」设置的后台账号。
支付入口没有显示
- 进入后台「支付」,确认对应方式的「启用此支付方式」已打开。关闭渠道后,服务端也会阻止发起付款。
- 检查「支持的货币」是否包含当前订单币种。币种不匹配时,前台会过滤该方式,服务端也会拒绝付款。
- 检查购买项目是否有当前币种的有效价格,以及当前用户是否满足购买条件。
- 如果是游客,确认该业务和渠道允许游客购买。登录后可用,不代表游客也可用。
- 如果在微信浏览器内操作,检查该渠道是否支持微信内付款。前台会按浏览器条件筛选渠道。
验证时应使用出问题的前端、币种和登录状态重新打开同一购买入口。重新支付已有订单时,还应核对订单原有币种,不要只看页面当前选择的币种。
能看到入口,但无法创建订单
先记录页面完整提示,再按提示检查:
| 提示或现象 | 检查方法 |
|---|---|
| 支付方式已关闭 | 核对后台渠道开关,保存后重新打开付款页面。 |
| Currency not found | 检查订单币种是否在该渠道「支持的货币」中。 |
| 需要有效用户或游客会话 | 核对当前登录或游客会话,重新进入购买流程后再试。 |
| 游客需要有效邮箱 | 检查付款资料中的邮箱是否填写完整、格式是否正确。 |
| Coupons require an account | 当前游客不能使用优惠券,需要登录账号后使用。 |
| 认证、签名或配置错误 | 检查所选渠道、测试或正式环境、密钥类型,以及应用与商户参数是否配套。 |
修正后,先确认能正常创建订单,再继续付款测试。如果已有扣款记录,应先核对原订单结果,避免重复付款。
订单已创建,收银台或二维码打不开
检查「前台支付形式」是否与接口结果一致。网页收银台通常使用「跳转收银台」;接口实际返回二维码时才使用「扫码」。选择扫码不会把普通跳转地址变成二维码支付。
若应打开新窗口却没有打开,检查浏览器是否拦截弹窗。若显示支付响应异常,需要核对接口是否返回了完整订单信息、二维码或付款参数,不能只靠切换显示形式解决。
已经扣款,订单仍未确认
先核对支付平台记录与瓜奇订单是否对应,包括订单号、时间、金额和币种。浏览器返回网站只是其中一步,不能单独证明订单已确认付款。
检查目标前端的 /api/callback 是否能被支付平台访问。该入口会接收通知正文和签名信息,再转发至 WordPress 的 /gq/pay-callback 处理;前端收到请求,不代表 WordPress 已处理成功。
继续检查通知是否送达、转发是否成功、签名是否通过,以及订单处理是否返回错误。PayPal 和 Stripe 还需核对通知端点与相应 Webhook 配置是否匹配。
本机能打开前后台,不代表外部支付平台能访问本机。若通知入口仅 localhost 可达,应先准备可达的测试入口;在通知未验证前,不要把整个付款流程记为测试通过。
订单已确认,内容或权益仍不可用
核对订单购买的业务类型、内容 ID、买家身份和当前前端,再检查交付结果。例如,订单购买的文章与当前打开的译文是否对应,用户是否在同一网站和同一身份下访问。
这一阶段应查订单与具体业务的交付关系。不要只因内容未解锁就要求买家再次付款。
整理排查信息
反馈时提供订单号、发生时间、前端网址、币种、渠道、登录状态、浏览器,以及完整公开提示。说明问题停在哪一步、前面的步骤是否已验证。不要附上私钥、Secret 或客户支付凭据。