# @guestyorg/tokenization-js 中文文档

规范地址：https://npmcn.com/package/%40guestyorg/tokenization-js/

版本：1\.2\.0
npm 元数据更新时间：2026-09-02T11:20:25.194Z
中文译文更新时间：2026-11-17T02:55:48.904Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40guestyorg/tokenization-js
原文对照：https://npmcn.com/package/%40guestyorg/tokenization-js/?lang=original
项目主页：https://github.com/guestyorg/tokenization-js/wiki
源码仓库：https://github.com/guestyorg/tokenization-js

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

- 包体积（解压后）：30.7 kB，36 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2023-09-14T15:06:06.511Z
- 最新版本发布：2026-09-02T11:20:24.965Z
- 近 30 天下载量：33203（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 1 个）

## 中文简介

客串化 SDK 装载工具及类型

## 安装

```sh
npm install @guestyorg/tokenization-js
```

也可以使用：`pnpm add @guestyorg/tokenization-js`、`yarn add @guestyorg/tokenization-js`、`bun add @guestyorg/tokenization-js`

## README

# [JS SDK 客串化](https://github.com/guestyorg/tokenization-js/wiki)

融合SDK有两种方法:

### 手动包含脚本标签

在您的应用程序中添加脚本标签 `head` 或者说 `body`。 。 。 . 此负载 `guestyTokenization` 全局对象 `window` 浏览器范围

```html
<script src="https://pay.guesty.com/tokenization/v3/init.js"></script>
```

### 用它作为ES模块

将 SDK 装入模块的好处 :

-   同步加载脚本以确保页面渲染不被屏蔽
-   返回一个承诺,以知道脚本装入何时完成
-   决定: `null` 如果在服务器环境中调用

#### 注意: 要符合PCI, 您必须直接装入 SDK [https://pay.guesty.com (英语)](https://pay.guesty.com/) (或者通过添加脚本标记或者使用ES模块). 你不能把它包含在一个捆绑或主机.

## 安装

使用 `npm` 安装Guesty Tokenization JS模块:

```sh
npm install @guestyorg/tokenization-js
```

## 使用量

导入 `loadScript` 用于同步装入 Guesty Tokenization JS SDK 的功能

### 加载脚本( 选项 )

-   接受一个 `options` 对象以配置脚本 URL 和属性
-   返回以 `window.guestyTokenization` sDK 装入完成后

#### 选项

-   `sandbox` - 把SDK装入沙盒模式
-   `version` - 要装入的 SDK 版本( 默认 ): `v1`) (中文(简体) ). 支持的数值 : `v1`, (中文(简体) ), `v2`, (中文(简体) ), `v3`

```js
loadScript({ sandbox: true, version: 'v3' });
```

这相当于以下剧本:

```html
<script
  src="https://pay.guesty.com/tokenization/v3/init.js"
  data-env="sandbox"
></script>
```

#### 自动/等待

```js
import { loadScript } from '@guestyorg/tokenization-js';

try {
  const guestyTokenization = await loadScript({ version: 'v3' });
  // Guesty Tokenization JS SDK is loaded and ready to use
} catch (error) {
  console.error('Failed to load the Guesty Tokenization JS SDK script', error);
}
```

#### 承诺

```js
import { loadScript } from '@guestyorg/tokenization-js';

loadScript({ version: 'v3' })
  .then((guestyTokenization) => {
    // Guesty Tokenization JS SDK is loaded and ready to use
  })
  .catch((error) => {
    console.error(
      'Failed to load the Guesty Tokenization JS SDK script',
      error
    );
  });
```

## 类型脚本支持

这个包包括了Guesty Tokenization JS SDK的TypeScript类型定义. 这包括用于 `window.guestyTokenization` 名称空间。 我们支持使用 TypeScript 版本\\\\ 3.8 的项目.

## 常见问题

### @guestyorg/tokenization-js 是什么？

客串化 SDK 装载工具及类型

### 如何安装 @guestyorg/tokenization-js？

在项目目录运行 npm install @guestyorg/tokenization-js，或使用 pnpm add / yarn add / bun add。

### @guestyorg/tokenization-js 支持 TypeScript 吗？

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

### @guestyorg/tokenization-js 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @guestyorg/tokenization-js 可以商用吗？

@guestyorg/tokenization-js 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @guestyorg/tokenization-js 的下载量有多少？

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

### @guestyorg/tokenization-js 还在维护吗？

最新版本 1\.2\.0 发布于 2026/09/02（2 个月前）；至今共发布 9 个版本，其中过去 12 个月发布了 1 个；首次发布于 2023/09/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

