瓜奇
瓜奇

暂无菜单项

首页/文档/商品与交易/支付接入/
打开 MD 链接

排查支付入口和支付结果异常

二丿小青年
二丿小青年
发布于 9/11更新于 10/13
43

06 商品与交易 / 06.02 支付接入

先确认问题停在哪一步

按「显示支付入口 → 创建订单 → 完成付款 → 确认订单 → 交付内容」的顺序检查。先找出最后一个正常完成的步骤,再排查下一步。

准备订单号、发生时间、买家访问的前端网址、币种、支付渠道、浏览器和登录状态。查看或修改渠道配置,需要使用能进入并保存瓜奇「支付」设置的后台账号。

支付入口没有显示

  1. 进入后台「支付」,确认对应方式的「启用此支付方式」已打开。关闭渠道后,服务端也会阻止发起付款。
  2. 检查「支持的货币」是否包含当前订单币种。币种不匹配时,前台会过滤该方式,服务端也会拒绝付款。
  3. 检查购买项目是否有当前币种的有效价格,以及当前用户是否满足购买条件。
  4. 如果是游客,确认该业务和渠道允许游客购买。登录后可用,不代表游客也可用。
  5. 如果在微信浏览器内操作,检查该渠道是否支持微信内付款。前台会按浏览器条件筛选渠道。

验证时应使用出问题的前端、币种和登录状态重新打开同一购买入口。重新支付已有订单时,还应核对订单原有币种,不要只看页面当前选择的币种。

能看到入口,但无法创建订单

先记录页面完整提示,再按提示检查:

提示或现象 检查方法
支付方式已关闭 核对后台渠道开关,保存后重新打开付款页面。
Currency not found 检查订单币种是否在该渠道「支持的货币」中。
需要有效用户或游客会话 核对当前登录或游客会话,重新进入购买流程后再试。
游客需要有效邮箱 检查付款资料中的邮箱是否填写完整、格式是否正确。
Coupons require an account 当前游客不能使用优惠券,需要登录账号后使用。
认证、签名或配置错误 检查所选渠道、测试或正式环境、密钥类型,以及应用与商户参数是否配套。

修正后,先确认能正常创建订单,再继续付款测试。如果已有扣款记录,应先核对原订单结果,避免重复付款。

订单已创建,收银台或二维码打不开

检查「前台支付形式」是否与接口结果一致。网页收银台通常使用「跳转收银台」;接口实际返回二维码时才使用「扫码」。选择扫码不会把普通跳转地址变成二维码支付。

若应打开新窗口却没有打开,检查浏览器是否拦截弹窗。若显示支付响应异常,需要核对接口是否返回了完整订单信息、二维码或付款参数,不能只靠切换显示形式解决。

已经扣款,订单仍未确认

先核对支付平台记录与瓜奇订单是否对应,包括订单号、时间、金额和币种。浏览器返回网站只是其中一步,不能单独证明订单已确认付款。

检查目标前端的 /api/callback 是否能被支付平台访问。该入口会接收通知正文和签名信息,再转发至 WordPress 的 /gq/pay-callback 处理;前端收到请求,不代表 WordPress 已处理成功。

继续检查通知是否送达、转发是否成功、签名是否通过,以及订单处理是否返回错误。PayPal 和 Stripe 还需核对通知端点与相应 Webhook 配置是否匹配。

本机能打开前后台,不代表外部支付平台能访问本机。若通知入口仅 localhost 可达,应先准备可达的测试入口;在通知未验证前,不要把整个付款流程记为测试通过。

订单已确认,内容或权益仍不可用

核对订单购买的业务类型、内容 ID、买家身份和当前前端,再检查交付结果。例如,订单购买的文章与当前打开的译文是否对应,用户是否在同一网站和同一身份下访问。

这一阶段应查订单与具体业务的交付关系。不要只因内容未解锁就要求买家再次付款。

整理排查信息

反馈时提供订单号、发生时间、前端网址、币种、渠道、登录状态、浏览器,以及完整公开提示。说明问题停在哪一步、前面的步骤是否已验证。不要附上私钥、Secret 或客户支付凭据。

相关文档

  • 配置Stripe接入
  • 理解订单询盘和ERP对接设置
  • 排查第三方连接认证与超时问题
上一篇
配置Stripe接入Stripe 接入需要区分 API 私钥和 Webhook 签名密钥:前者用于创建付款会话,后者用于验证 St…
下一篇
配置虚拟商品数字交付打开商品编辑页,先将商品设为虚拟商品,再配置「数字交付」。请使用有权编辑该商品的后台账号操作。
0 / 600
细中粗
0 讨论
热门最新
总结
暂无总结
瓜奇
瓜奇
首页
产品中心优惠
扩展中心
模板中心
小店
AI导航
社区演示
文档中心
构建器夯
所有的成功,都源自一个勇敢的开始
不辜负每一个勇敢的开始
关于帮助文档FAQ协议
瓜奇 © 2026