@flittpayments/flitt-node-js-sdk

中文文档
2.0.0发布于 2026/08/29GPL-3.0TypeScriptCommonJS零依赖近 30 天下载 3896

中文使用文档
文档目录12 节
  1. 付款服务提供者
  2. 安装
  3. 需求
  4. 简单开始
  5. Python SDK 2.0 添加的 API
  6. 开放银行业务和分期付款
  7. IBAN 撤销
  8. 全面获取、全面反向和财政数据
  9. 公司报告
  10. 折旧方法
  11. 通知
  12. 实例

Flitt NODEJS- SDK (英语)

raiting raiting raiting

付款服务提供者

一个支付服务商(PSP)提供商店在线服务,通过包括信用卡在内的多种支付方法接受电子支付,直接借记等银行支付,银行转账,以及基于在线银行的实时银行转账. 通常情况下,他们使用软件作为服务模式,并为他们的客户(商人)组成一个单一的支付网关,以获得多种支付方法. 更多信息

安装

npm install @flittpayments/flitt-node-js-sdk

手动安装

git clone -b master https://github.com/flittpayments/node-js-sdk.git

需求

node >= 7

简单开始

const FlittPay = require('@flittpayments/flitt-node-js-sdk')

const flitt = new FlittPay(
  {
    merchantId: 1549901,
    secretKey: 'test'
  }
)
const requestData = {
  order_id: 'Your Order Id',
  order_desc: 'test order',
  currency: 'GEL',
  amount: '1000'
}
flitt.Checkout(requestData).then(data => {
  console.log(data)
}).catch((error) => {
  console.log(error)
})

Python SDK 2.0 添加的 API

节点SDK包括添加到Python SDK 2.0 API中的支付方法.

开放银行业务和分期付款

const openBanking = await flitt.OpenBanking({
  currency: 'GEL',
  amount: 10000,
  payment_method: 'tbc'
})

const installments = await flitt.Installments({
  currency: 'GEL',
  amount: 5000,
  payment_method: 'tbc'
})

回来的 checkout_url 可以是银行应用的深层链接。 在明确用户动作后,不修改地将其传给客户,并使用服务器回调确认付款或 Status。 。 。 .

IBAN 撤销

IBAN 退出使用 配置为 creditKey。 。 。 .

const payout = await flitt.Ibancredit({
  currency: 'GEL',
  amount: 10000,
  receiver_iban: 'GE00TB0000000000000001'
})

全面获取、全面反向和财政数据

await flitt.CaptureFull({ order_id: 'order-id', currency: 'GEL' })
await flitt.ReverseFull({ order_id: 'order-id', currency: 'GEL' })
const fiscalData = await flitt.FiscalData({ order_id: 'order-id' })

CaptureFull 财务报告和审定财务报表 ReverseFull 首先请求当前订单状态,并在客户端收费和先前倒置后计算可用的金额.

公司报告

公司报告采用单独的 application_id 财务报告和审定财务报表 key 全权证书及全权证书审查报告 portal.flitt.com 服务。 以构建器选项覆盖域 reportsBaseUrl 需要的时候.

const report = await flitt.CompanyReports({
  application_id: 'application-id',
  key: 'reports-key',
  report_id: 745,
  merchant_id: 1549902,
  filters: []
})

Reports 接受相同的公司报告数据作为兼容性别名。 使用旧的呼叫 date_from编号 :date_to 形状仍然达到遗留的终点,但该用法已经贬值.

折旧方法

  • TransactionList 用于向后兼容,但已从 Python SDK 2.0 API 中删除。 使用 Status 用于当前顺序状态.
  • LegacyReports 和日期 Reports 使用遗产 /reports/ 终点 用于向后兼容; 使用 CompanyReports 或者说 Reports 公司报告证书.

通知

merchant_data 必须是字符串.

示例

 const merchant_data = JSON.stringify([{
    email: '[email protected]',
    comment: 'Some comment'
 }])

阿庇语Name

见 文档

实例

见所有 SDK 实例,包括:

版本与发布记录

@flittpayments/flitt-node-js-sdk 共发布 4 个版本,首次发布于 2025/03/27;过去 12 个月发布了 1 个版本。

版本发布日期距今
2.0.0latest2026/08/292 个月前
1.0.12025/03/271.6 年前
1.0.02025/03/271.6 年前
1.0.82025/03/271.6 年前

关于 @flittpayments/flitt-node-js-sdk 的常见问题

如何安装 @flittpayments/flitt-node-js-sdk?

在项目目录运行 npm install @flittpayments/flitt-node-js-sdk,或使用 pnpm add / yarn add / bun add。

@flittpayments/flitt-node-js-sdk 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@flittpayments/flitt-node-js-sdk 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@flittpayments/flitt-node-js-sdk 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=7.6.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@flittpayments/flitt-node-js-sdk 可以商用吗?

@flittpayments/flitt-node-js-sdk 使用 GPL-3.0 许可。强 Copyleft:分发包含该代码的软件时,整个作品需以 GPL-3.0 兼容许可开源,并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括,不构成法律意见,请以许可原文为准。

@flittpayments/flitt-node-js-sdk 的下载量有多少?

根据 npm 官方下载统计,@flittpayments/flitt-node-js-sdk 在 2026/10/15 – 2026/11/13 这 30 天内被下载 3,896 次,日均约 130 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@flittpayments/flitt-node-js-sdk 还在维护吗?

最新版本 2.0.0 发布于 2026/08/29(2 个月前);至今共发布 4 个版本,其中过去 12 个月发布了 1 个;首次发布于 2025/03/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。