SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场setup-fiuu

setup-fiuu

编程与开发

查看项目

更新于 10-15 10:10

技能介绍

用途

setup-fiuu 用于 Fiuu 支付网关的集成工作，支持搭建、构建、调试、审查和讲解 Fiuu 支付集成。它依据官方 Fiuu API 规范，覆盖 Seamless Integration、Inpage Checkout、Mobile XDK、SDK 等集成方式。

参考资料

在给出事实性 API 指导或编写集成代码前，应先阅读 references/fiuu-api.md。该文件包含源 URL、集成面、环境主机、端点角色、vcode/skey 公式、webhook/IPN 指引、移动 XDK 事实以及漏洞修复。

当用户询问如何注册、需要哪些凭据、密钥来源，或需要哪些仪表盘/域名设置时，阅读 references/account-setup.md。

当需要选择 Fiuu GitHub 仓库、SDK、插件或移动平台参考时，阅读 references/source-map.md。

核心工作流

  1. 识别环境：sandbox/UAT/dev/production，以及 web、mobile、plugin、POS 或 recurring 流程。
  2. 选择集成面：Hosted Payment Page、Seamless Integration、Inpage Checkout、Mobile XDK、SDK、购物车插件、Direct Server、recurring、refund/capture、status requery 或 terminal/POS。
  3. 在将客户发送到 Fiuu 之前，创建本地待支付记录。
  4. 在需要时，于服务端生成请求哈希（vcode）。
  5. 配置并验证后端 Notify/Notification URL 和 Callback URL。Return URL 仅用于用户体验。
  6. 使用正确的公式和密钥，在服务端验证响应哈希（skey 或 XDK checksum/VrfKey）。
  7. 在需要时重新查询 Fiuu 状态，然后仅在金额、币种、订单 ID、商户 ID、状态和提供商参考匹配后才进行结算。
  8. 通过存储 Fiuu 交易 ID、订单 ID、事件/来源、验证结果和处理状态，使结算具备幂等性。

核心事实

主要托管支付请求 URL：

  • 生产环境：https://pay.fiuu.com/RMS/pay/{MerchantID}/{Payment_Method}
  • 沙箱环境：https://sandbox-payment.fiuu.com/RMS/pay/{MerchantID}/{Payment_Method}

沙箱中的 API 主机将 api.fiuu.com 替换为 sandbox-api.fiuu.com。

大多数 Fiuu API 请求使用 application/x-www-form-urlencoded，而非 JSON。

凭据可包括 Merchant ID、Verify Key、Secret Key、密码/API 凭据，以及特定环境的 sandbox/live 值。

常见 Web 状态码：00 成功，11 失败，22 待处理。

Return URL 面向浏览器，不可靠，不能用于履约。

Notify/Notification URL 是用于支付状态的主要服务器到服务器 webhook。

Callback URL 处理非实时/延迟状态变更，例如现金渠道。

启用后，IPN ACK 可触发重试行为；在持久记录之前不要确认。

工作规则

  • 不要在浏览器/移动代码中暴露 Verify Key、Secret Key、API 密码或私有签名输入。
  • 不要仅凭 Return URL、重定向、移动端结果或前端事件标记为已支付。
  • 始终在后端验证 Fiuu 哈希，并比较本地存储的支付数据。
  • 对于 Seamless Integration，确认域名注册/白名单，并在渠道选择由商户侧进行时，对已订阅渠道使用 Channel Status API。
  • 不要 iframe 银行登录/授权页面；银行/渠道可能阻止跨源流程。
  • 除非明确处理 PCI-DSS 范围和 Fiuu 批准，否则不要使用 Direct Server/Card 集成。
  • 对于移动 XDK，将返回的结果/校验和发送到后端进行验证，尤其是在使用私有 Secret Key 时。
  • 如果用户询问最新费用、渠道可用性、仪表盘状态、入驻要求、插件兼容性或账户特定启用情况，请先核实实时 Fiuu 文档/仪表盘/支持。

适用场景

适用于需要集成 Fiuu 支付网关的 Web、移动、插件、POS 或 recurring 支付流程的开发与调试工作，包括托管支付页、无缝集成、Inpage Checkout、Mobile XDK、SDK、购物车插件、Direct Server、退款/捕获、状态重查和终端/POS 等场景。

限制

资料未提供具体费用、价格、渠道可用性、仪表盘状态、入驻要求、插件兼容性或账户特定启用情况，这些需核实实时 Fiuu 文档/仪表盘/支持。资料未提供官方文本。