文章目录
- Hyperswitch:开源支付基础设施,43K Star 的"Linux for Payments"
- 1、 这是什么项目
- 2、 它是怎么设计的
- 3、 怎么跑起来
- 4、 生态组成
- 5、 谁适合用
Hyperswitch:开源支付基础设施,43K Star 的"Linux for Payments"
hyperswitch 在 GitHub 上已经拿到 43,138 Star 了。
做电商、做 SaaS,只要涉及在线收款,就绕不开支付对接这件事。Stripe 也好,Adyen 也好,每家支付服务商的接口都不一样。业务扩大之后要接第二家、第三家,每次都得重新写一遍集成逻辑。Hyperswitch 就是来解决这个问题的。
1、 这是什么项目
Hyperswitch 是一套开源支付基础设施,用 Rust 写的。它把 Stripe、Adyen、Braintree、Worldpay、Checkout.com、Cybersource 以及 120 多个支付处理器的接口统一成一套 API,开发者只需要对接一次,就能在不同的支付服务商之间切换。不用被绑定在某一家支付服务商上。
项目官方的说法是"Linux for Payments",意思是像 Linux 操作系统一样,给你一套可组合的底层能力,你自己决定怎么用。
2、 它是怎么设计的
Hyperswitch 的架构是模块化的。每个模块独立运行,企业可以根据自己的需要,只选其中几个模块接入,不用把整套系统都搬过来。
主要模块有这几个:
- 成本可观测性:审计和监控支付成本,发现隐藏费用、降级扣费等问题,提供自助式的数据看板。
- 收入恢复:针对被动流失的交易做智能重试,支持按卡 BIN、地区、支付方式等维度控制重试策略和惩罚预算。
- Vault:PCI 合规的支付凭证存储,支持卡、钱包、银行账户等。也能接入已有的 Vault 方案,比如 VGS、TokenEx,不用重新做数据迁移。
- 智能路由:每一笔交易根据预测的授权率,自动分配到最合适的支付处理器,减少重试和失败。
- 对账:自动化双向和三向对账,支持回溯和定时调度,减少人工核对的工作量。
- 替代支付方式:集成了 PayPal、Apple Pay、Google Pay、Samsung Pay、Klarna 等,提供现成的前端组件。
3、 怎么跑起来
本地部署用 Docker,三步搞定:
gitclone--depth1--branchlatest https://github.com/juspay/hyperswitchcdhyperswitch scripts/setup.sh脚本会自动检测 Docker 或 Podman 环境,然后提供三种部署模式:Standard(应用服务 + 控制中心)、Full(加上监控和调度器)、Minimal(只有应用服务)。跑完之后会给访问地址。
不想本地搭环境的话,官方提供了托管的沙箱环境,注册就能直接用。可以在里面配置支付连接器、查看日志和路由规则、测试支付流程,不需要部署任何东西。
4、 生态组成
Hyperswitch 不只是一个单独的项目,它是一整套生态:
- 核心后端:Rust 写的应用服务器,负责路由、重试、Vault、可观测性。配套的 card-vault 做 PCI 合规存储,encryption-service 处理加解密。
- 控制中心:商户用的管理后台,配置连接器、设置路由规则、查看交易数据。用 ReScript 写的。
- Web SDK:浏览器端的结账组件,支持 React。
- 移动端 SDK:Android(Kotlin)、iOS(Swift)、React Native、Flutter,四个平台都有官方支持。
- 部署工具:Terraform 和 Helm Charts,支持 AWS、GCP、Azure。
5、 谁适合用
- 已经接了 Stripe 或 Braintree,想扩展到多个支付处理器的团队
- 需要直接连接收单机构(比如 TSYS、JP Morgan Payments)的商户
- 想自建支付平台、但又不想从零开始的开发者
- 已经有 Vault 或其他支付基础设施,需要做增量替换的企业
这个项目是 Apache 2.0 协议,由 Juspay 团队维护,这家公司本身就在给 400 多家企业提供支付基础设施服务。
项目是 Apache 2.0 协议,由 Juspay 团队维护,这家公司本身就在给 400 多家企业提供支付基础设施服务。