Skip to main content
如果你已经向 Tango、Runa 或 InComm 发送礼品卡订单，那么无需重建即可从 Fluz 购买。更改基础 URL、更换凭证，其余代码保持不变。 这正是API 适配器的作用。

​
什么是 API 适配器

我们将我们的 API 调用映射到了他们的接口。你的供应商所暴露的每个操作——创建订单、检查订单、读取余额——在 Fluz 里都有对应的操作，适配器位于中间，负责双向翻译。 结果就是，你先前面向 Tango、Runa 或 InComm 构建的集成现在改为从 Fluz 采购。你保留原有的请求结构，并收到你的解析器已期待的响应结构中的成功结果。 有两样是 Fluz 自有的，而不是你的供应商的：错误响应和订单状态值。二者均在连接器行为中说明。 Fluz API 适配器的工作方式 把它想象成旅行用的插头转换器。电器不变，墙上的插座不变，中间有个装置让两者匹配。

​
映射的工作方式

你的请求以供应商的形状到达。适配器将路由和字段翻译成等价的 Fluz 操作，在 Fluz 供给上执行，然后将结果翻译回你的代码已期待的响应结构。 通过 Fluz API 适配器的请求与响应映射

​
操作映射

每个连接器页面都会发布其供应商的完整映射表。以 Tango Card 为例： 路径和动词是刻意保持不变的。适配器的意义在于，你的路由层无需感知任何改变。

​
字段映射

再次以 Tango Card 为例：
Tango 和 InComm 会同步返回完整结果。 调用在购买完成前不会返回，可能需要长达 150 秒，因此请将客户端的读取超时设置得高于此。Runa 默认是异步：它会立即返回一个引用 ID，你需在完成后再读取订单。发送 X-Execution-Mode: sync 可改为等待完整结果。二者均在连接器行为中说明。

​
各供应商的请求约束

你的供应商请求结构会按原样接受，但少数取值被固定。必须关闭对收件人的邮件投递，订单为单收件人且单产品，且 Runa 订单必须使用美元账户余额出资。违反上述任一规则的请求会被拒绝。 完整列表见连接器行为。在切换前，请结合你的连接器页面上的请求示例一起阅读。

​
哪些会改变，哪些不会

品牌标识符是你必须更改的唯一项。 适配器不会将供应商的产品目录翻译为 Fluz 的。Tango 的 utid 为 U561593 并不等同于 Fluz 的 utid 为 1800FL-US。在切换前，请将你的品牌清单与 Fluz 目录进行映射，否则你的订单会成功但发放到错误的卡。

​
三步完成切换

1

更改基础 URL

将你现有的客户端指向该供应商的 Fluz 适配器主机。对于 Tango Card，测试环境为 https://api-adapter.staging.fluzapp.com/tangocard，生产环境为 https://api-adapter.fluzapp.com/tangocard，替代 https://integration-api.tangocard.com/rass。每个连接器页面都会列出两个主机。
2

更改 Authorization 头

每个连接器都使用携带你的 Fluz API key 的 HTTP Basic 认证：Authorization: Basic <FLUZ-API-Key>。移除供应商的用户名与密码。
3

重新映射你的品牌标识符并发送相同调用

将供应商产品代码替换为其 Fluz 等价物。其他一切——路径、动词、请求体、响应解析——保持不变。

​
可用的连接器

礼品卡

已文档化并可用。 Tango Card、Runa、InComm——每个都有已发布的端点对照与请求示例。

支付处理

Beta。 Stripe、Worldpay、TSYS、Checkout、Braintree、TabaPay、Finix、Authorize.net、Sola / Cardknox。请联系销售以获取提前访问与端点详情。

钱包提现

Beta。 Venmo 和 PayPal。请联系销售以获取提前访问与端点详情。
礼品卡连接器已较为成熟，也是目前唯一具备发布到操作级别文档的系列。每个礼品卡连接器页面都会列出已实现的具体操作，以及其对应的原始供应商端点。

​
覆盖范围以操作为单位

适配器仅实现每个连接器页面上列出的那些操作。 每个操作都是为该操作量身定制的翻译，而非一刀切的透传。
如果某个操作未出现在连接器页面的端点对照表中，说明它尚未构建。 在开始之前，列出你今天的集成所调用的每一个供应商端点，并逐一与连接器页面核对。如果缺少了你依赖的内容，请在启动前告知你的 Fluz 联系人——大多数缺口都是一些小补充，但仍需要进行范围评估。

​
连接器与 Fluz GraphQL API 相互独立

这点常让人混淆，因此值得直说。Fluz 提供两种截然不同的开发者接口，并且它们不共享凭证。
连接器密钥不是控制台密钥。 你在 Fluz 控制台的 Developers 分区生成的 API key 无法用于连接器认证，反之亦然。连接器凭证由 Fluz 配置。请联系你的 Fluz 代表以申请。

​
何时使用连接器，何时不该

适合使用连接器的场景

你已有上线运行的供应商集成，想要快速获得 Fluz 供给与 Fluz 费率，并且不希望为切换投入一个工程周期。上线周期以天计。

适合使用 Fluz API 的场景

你想要完整的平台能力：虚拟卡、钱包与消费账户、交易数据、webhooks、返现费率、报价，以及完整的商户目录。这些都无法通过供应商形接口访问。
常见路径是先用连接器让交易量流入，然后在逐步采用旧供应商不具备的能力时迁移到Fluz API。

​
获取访问权限

API 连接器目前以 beta 计划提供。请联系你的 Fluz 代表或发送邮件至销售团队以申请连接器凭证，并确认你所用供应商的操作覆盖范围。

​
选择你的供应商

Tango Card

订单与账户余额。Basic 认证，同步响应。

Runa

订单与货币余额。同步与异步执行模式。

InComm

即时下单、订单详情、卡片获取与项目余额。