# @flittpayments/flitt-node-js-sdk 中文文档

规范地址：https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/

版本：2\.0\.0
npm 元数据更新时间：2026-08-29T11:34:18.415Z
中文译文更新时间：2026-11-14T23:28:14.676Z
软件包许可：GPL-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40flittpayments/flitt-node-js-sdk
原文对照：https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/?lang=original
项目主页：https://github.com/flittpayments/node-js-sdk#readme
源码仓库：https://github.com/flittpayments/node-js-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：72.2 kB，28 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=7\.6\.0
- 运行依赖：0 个
- 首次发布：2025-03-27T11:52:13.745Z
- 最新版本发布：2026-08-29T11:34:18.241Z
- 近 30 天下载量：3896（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 1 个）

## 中文简介

![](https://flitt.com/wp-content/uploads/2024/09/Group.svg)

[](https://www.npmjs.com/package/@flittpayments/flitt-node-js-sdk)

## 安装

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

也可以使用：`pnpm add @flittpayments/flitt-node-js-sdk`、`yarn add @flittpayments/flitt-node-js-sdk`、`bun add @flittpayments/flitt-node-js-sdk`

## README

# Flitt NODEJS- SDK (英语)

![](https://flitt.com/wp-content/uploads/2024/09/Group.svg)

[![raiting](https://img.shields.io/npm/v/@flittpayments/flitt-node-js-sdk.svg)](https://www.npmjs.com/package/@flittpayments/flitt-node-js-sdk) [![raiting](https://img.shields.io/npm/dt/@flittpayments/flitt-node-js-sdk.svg)](https://www.npmjs.com/package/@flittpayments/flitt-node-js-sdk) [![raiting](https://img.shields.io/npm/dw/@flittpayments/flitt-node-js-sdk.svg)](https://www.npmjs.com/package/@flittpayments/flitt-node-js-sdk)

## 付款服务提供者

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

## 安装

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

#### 手动安装

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

## 需求

```
node >= 7
```

## 简单开始

```javascript
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中的支付方法.

### 开放银行业务和分期付款

```javascript
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`。 。 。 .

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

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

```javascript
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` 需要的时候.

```javascript
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: 'test@flitt.eu',
    comment: 'Some comment'
 }])
```

# 阿庇语Name

见 [文档](https://docs.flitt.com/)

## 实例

见所有 [SDK 实例](https://github.com/flittpayments/node-js-sdk/tree/master/examples),包括:

-   [开放银行业务](https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/examples/open_banking.js)
-   [安装](https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/examples/installments.js)
-   [IBAN 撤销](https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/examples/ibancredit.js)
-   [完全捕获](https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/examples/capture_full.js) 财务报告和审定财务报表 [完全倒转](https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/examples/reverse_full.js)
-   [财政数据](https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/examples/fiscal_data.js)
-   [公司报告](https://npmcn.com/package/%40flittpayments/flitt-node-js-sdk/examples/reports.js)

## 常见问题

### 如何安装 @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 和提交记录判断。