跳转到主要内容

Infini WooCommerce 支付网关插件配置与使用指南

作者：Emy Huang

一、产品概述与使用条件

Infini Payment Gateway 是一款 WooCommerce 支付网关插件。顾客下单后会跳转至 Infini 托管收银台，可使用商户账户已开通的 Crypto、Card、Binance Pay、Apple Pay 或 Google Pay 完成付款。商店不直接接触银行卡或加密货币敏感支付信息。

安装前检查

要求

WordPress

5.0 及以上

WooCommerce

5.0 及以上

PHP

7.4 及以上

网站

必须使用 HTTPS

商店默认币种

USD、EUR、GBP、SGD、JPY、AUD 或 HKD

Infini 账户

生产账户或 Sandbox 账户

所需凭证

当前环境的 Key ID、Secret Key、Webhook Secret

重要：Webhook Secret 是独立密钥，不是 API Secret Key，不能混用。

二、安装插件

1、登录 WordPress 后台，进入「插件 > 安装新插件」。

2、点击「选择文件」，选择 infini-payment-gateway-1.4.0.zip。目前插件安装包通过对接群或商务渠道获取（后续将在商户后台提供下载）。

3、点击「立即安装」，安装完成后点击「启用插件」。

4、进入「WooCommerce > 设置 > Infini」点击【Manage】。

三、获取 Infini 凭证

生产环境

  1. 登录 https://business.infini.money

  2. 进入 Developer 页面并创建 API Key。

  3. 保存 Key ID 与 Secret Key，Secret Key 通常只显示一次。

  4. 获取独立的 Webhook Secret。

Sandbox 环境

  1. 登录 https://business-sandbox.infini.money

  2. 在 Developer 页面获取 Sandbox Key ID、Sandbox Secret Key 和 Sandbox Webhook Secret。

四、配置插件

进入「WooCommerce > 设置 > 支付 > Infini」，填写当前环境对应的凭证并保存。

关键设置

设置项

建议

Enable/Disable

配置完成并通过检查后启用

Title / Description

显示在结账页，可按品牌语气修改

Order status after payment

默认 Automatic

Key ID / Secret Key / Webhook Secret

生产凭证

Payment Methods

留空时使用 Infini 后台默认支付方式

Sandbox Mode

测试时开启，上线时关闭

Sandbox credentials

仅 Sandbox Mode 开启时使用

Debug Log

排查时临时开启，上线后关闭

支付后订单状态

  • Automatic（推荐）：实体商品进入 Processing；仅虚拟/可下载商品进入 Completed。

  • Always Completed：适合纯数字商品。

  • Always Processing：适合所有订单都需要人工履约的商户。

五、配置 Webhook

1、复制插件设置页显示的 Webhook URL：https://your-site.com/wc-api/infini_webhook/

重要提示：切换至正式环境前，请务必更新 Webhook URL

Infini 商户后台的 Webhook URL 只能配置一个，测试环境与正式环境共用同一个配置项。因此，当您从沙盒模式切换至正式环境时，需要手动将 Webhook URL 替换为正式环境对应的地址，否则 Infini 的支付结果通知将无法正确回调至您的商店，导致订单状态无法自动更新。

2、在 Infini 商户后台 Developer 页面新增 Webhook。订阅 order.create 和 order.update。

注意：Sandbox 与 Production 是独立环境，需要分别配置凭证和 Webhook。

3、保存后回到插件设置页执行 Configuration Check。

点击【Check Configuration】，检查项包括当前模式、支付后状态、凭证、API 鉴权、商店币种、HTTPS、Webhook Secret 和 Webhook URL 可达性。

  • Pass：已通过

  • Warning：通常仍需人工确认

  • Fail：应先修复再开放支付

六、测试并正式上线

Sandbox 测试

1、开启 Sandbox Mode，并填写 Sandbox 所需密钥信息。

2、在 Sandbox 后台配置 Webhook。

3、下测试订单并选择 Pay with Infini，验证跳转、付款、订单状态和订单备注。

4、测试结束后关闭 Sandbox Mode。

正式上线

1、关闭 Sandbox Mode，填写生产 Key ID、Secret Key、Webhook Secret

2、在生产后台配置 Webhook

3、Configuration Check 无 Fail

4、关闭 Debug Log

5、用小额真实订单完成端到端验证

订单状态与异常付款

Infini Webhook 事件

Infini 订单状态

WooCommerce 结果

order.create

pending

Pending payment，并添加支付已发起备注

order.update

processing

On-hold，记录已确认及确认中金额

order.update

paid

按"支付后订单状态"设置，进入 Processing 或 Completed

order.update

expired

Cancelled（未收到任何付款）

order.update

partial_paid

On-hold，保留资金，添加备注，需人工处理（退款或补单）

order.late_payment

paid / partial_paid

足额则按状态设置标记已付；仍不足额则保持 On-hold或者Cancelled，添加备注，需人工处理

插件会在订单备注中记录实际到账金额和差额，便于对账、退款和税务核算。

对于状态为 partial_paid（过期但已收到部分付款）或 expired（过期未付款）的订单，商户可登录 Infini 商户后台，手动将订单状态修改为 paid。修改后，Infini 可通过 Webhook 推送 order.update 事件，WooCommerce 订单状态将自动同步更新。

部分付款与容差

  • 订单有效期内部分付款：订单进入 On-hold，顾客可使用同一支付链接补足差额。

  • 商户后台已配置部分付款容差：Infini 认定结清后，插件信任 order.completed 并标记已付，同时记录实际到账和差额。

  • 订单已收到部分付款且过期：订单将保持 On-hold 状态，需人工介入处理（如退款或补单），请勿要求客户对原订单重新全额支付。

  • 容差仅在 Infini 商户后台设置，插件没有单独设置项。

重复付款保护

插件会复用进行中的支付链接，使用固定幂等 request_id，并通过数据库锁避免同一订单并发创建多个支付请求。已付款订单不能再次发起支付。

日志与故障排查

在插件设置中临时开启 Debug Log，然后进入「WooCommerce > 状态 > 日志」，选择 infini-payment-gateway 日志。

1、结账页看不到 Infini

  • 确认插件已启用

  • 当前环境凭证已填写

  • 商店币种受支持

  • WooCommerce 和插件均已启用

2、付款后状态未更新

  • Webhook Secret 是否正确，且不是 Secret Key

  • Webhook URL 是否为 HTTPS

  • 是否订阅 order.create 和 order.update

  • Sandbox/Production 模式与凭证是否一致

  • 查看 Configuration Check 和日志

3、Invalid signature

  • 重新复制当前环境的 Webhook Secret

  • 确认没有把 API Secret Key 填入 Webhook Secret

  • 确认 Infini 后台 Webhook 与插件当前模式属于同一环境

退款

v1.4.0 暂不支持从 WooCommerce 自动退款。请在 Infini 商户后台人工处理，并在 WooCommerce 订单中添加退款记录或内部备注。少付容差或多付订单退款前，应先核对订单备注中的实际到账金额。

七、常见问题

问：插件支持哪些支付方式和币种？

答：插件支持银行卡、Binance Pay、Apple Pay、Google Pay，具体可用的支付方式和币种取决于您的 Infini 账户配置。

问：如何处理退款？

答：目前插件暂不支持在 WooCommerce 后台直接发起退款。如需退款，请登录 Infini 商户后台手动操作。自动退款功能将在后续插件版本中提供。

问：支付过程安全吗？

答：是的。所有 API 通信均通过 HTTPS 加密传输。Webhook 数据通过 HMAC-SHA256 签名验证，并使用独立的 Webhook Secret，有效防止重放攻击和数据篡改，确保交易安全可靠。

问：为什么结账页面没有显示 Infini 支付选项？

答：请检查您的 WooCommerce 商店默认币种设置。只有当商店币种设置为 Infini 支持的法币（如 USD、EUR 等）时，支付选项才会显示。同时，您可以通过插件设置页面的“Check Configuration”按钮排查配置问题。

问：Webhook 丢失怎么办？

答：顾客返回 Thank You 页面时，插件会主动查询 Infini 订单状态进行补偿对账。

问：可以在有未完成订单时切换 Sandbox/Production 吗？

答：不建议。模式切换会同步改变 API Endpoint、Webhook Secret 和对账环境，应先处理或等待进行中订单结束。

免责声明：Infini 提供技术及支付基础设施服务，相关金融及支付服务由合作持牌机构提供，并受适用法律法规监管。具体服务内容及可用性可能因地区而异。本内容仅供参考，不构成任何形式的承诺或投资建议。本服务不面向中国大陆、美国及其他受限制地区提供。

相关文章
这是否解答了您的问题？