Stripe for JoomShopping
安装前请核对发布说明：Joomla 4–6; PHP ≥ 8.1。已提供证据的 JoomShopping 版本为 5.9.4。需要 cURL、可信 TLS 证书、JSON 和出站 HTTPS。最低要求不等于完整的兼容性测试。
安装与配置
备份网站文件和数据库。在 Joomla 后台打开 System → Install → Extensions → Upload Package File，上传 interoperia-stripe-joomshopping-1.4.6.zip，不要解压。先在商店的测试副本上操作，配置期间保持支付方式未发布。
安装后打开 Open Interoperia setup 链接，或进入 JoomShopping → Options → Payments → Stripe → Config。新支付方式初始为未发布的 TEST 模式；更新会保留配置和发布状态。填写具备所需 Checkout 权限的 TEST secret 或 restricted API key，然后点击 Save and check connection。在 Stripe Webhooks 中配置屏幕显示的 HTTPS 通知地址和事件，并保存对应的 endpoint identifier 和 signing secret。密钥字段留空保留原值；请使用专用删除控件清除。
测试支付与正式支付
凭据和通知配置必须来自同一服务商账户及同一环境。在测试商店中使用服务商的测试工具，并向测试用户发布该支付方式，使其出现在结账页面。核对服务商的支付结果与对应的商店订单。接收真实付款前，选择正式环境，填写该环境的凭据和通知设置，并检查访问权限及发布状态。测试成功不代表正式环境已验证。
取消、失败或未确认的支付
状态映射中的 Paid 必须与 Pending、Failed、Cancelled 不同。返回商店页面不等于付款成功。取消或失败的订单不能按已付款订单履行。如果结果不明确，重试前请将服务商记录与具体订单核对；第一笔支付尚未查清时，避免创建第二笔支付。
更新与支持
订单中注明了随附或续订的更新与支持期限。期限结束后，更新与支持停止，但已安装的插件会继续运行。续订是自愿的。商店、托管环境或服务商今后的变更可能需要更新插件。
请通过 https://interoperia.com/support/ 或购买时提供的联系方式求助。请提供订单号、插件、Joomla、JoomShopping 和 PHP 的版本，以及错误信息。不要发送密码、API 密钥或银行卡信息。
应该安装哪个 ZIP？
请使用上方指定名称的产品安装包，从您的 Interoperia 下载中获取。源代码、审核及证据归档不是安装包。
需要服务商账户吗？
需要。您须提供自己的商户账户及下方列出的凭据。服务商合同及手续费独立于插件购买。
为什么结账时没有该支付方式？
请检查 JoomShopping 中的发布状态与访问权限。未发布的支付方式不会提供给顾客。
为什么已保存的密钥字段是空白？
密钥字段留空会保留已保存的值。不要仅因内容被隐藏就输入替代值。
保存配置能证明连接正常吗？
不能。保存配置、检查连接和确认支付是不同的步骤。
为什么订单仍在等待中？
支付可能尚未完成或未被确认。更改订单状态前，请检查服务商记录和通知配置。
有待处理支付时可以更换账户吗？
请先查清待处理支付，再更换账户或环境，以免失去将其与订单核对的能力。
更新后需要做什么？
先备份，再通过 Joomla 安装新版 ZIP，并检查保留的配置。在测试商店中重新检查连接和支付流程。
支持到期后插件会停用吗？
不会。到期停止的是更新与支持，而不是继续使用已安装插件的权利。
最低版本要求代表所有更高版本均已测试吗？
不代表。请对照发布要求与测试环境检查您的配置。其他配置应先在商店副本上测试。
版本与使用要求
| 版本 1.4.5-experience.3 | Joomla 6.1.3 / JoomShopping 5.9.4 / PHP 8.3.33 | PASSED | 2026-10-10 |
|---|
安装证据包含较早的软件包版本。当前版本已证实的是单独的沙箱支付测试，而非新的完整安装验证矩阵。
同时使用多个支付插件时，需要采用已验证共享库兼容性的版本。此处所述支付测试分别进行。