@guestyorg/tokenization-js

中文文档
1.2.0发布于 2026/09/02MITTypeScriptESM + CJS零依赖近 30 天下载 3.3万

Guesty Tokenization SDK loading utility and types

原始使用文档
文档目录6 节
  1. Manually include a script tag
  2. Use it as an ES module
  3. Installation
  4. Usage
  5. loadScript(options?)
  6. TypeScript Support

Guesty Tokenization JS SDK

There are two ways to integrate the SDK:

Manually include a script tag

Add a script tag to your application head or body. This loads guestyTokenization object to the global window scope of the browser

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

Use it as an ES module

Advantages of loading the SDK as a module:

  • loads script asynchronously to ensure page rendering isn't blocked
  • returns a Promise to know when script loading is complete
  • resolves to null if called in a server environment

Note: To be PCI-compliant, you must load the SDK directly from https://pay.guesty.com (either by adding a script tag or using the ES module). You cannot include it in a bundle or host it yourself.

Installation

Use npm to install the Guesty Tokenization JS module:

npm install @guestyorg/tokenization-js

Usage

Import the loadScript function for asynchronously loading the Guesty Tokenization JS SDK

loadScript(options?)

  • accepts an options object to configure script URL and attributes
  • returns a Promise that resolves with window.guestyTokenization after the SDK is finished loading

options

  • sandbox - load the SDK in a sandbox mode
  • version - SDK version to load (default: v1). Supported values: v1, v2, v3
loadScript({ sandbox: true, version: 'v3' });

This is equivalent to the following script:

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

Async/Await

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);
}

Promises

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
    );
  });

TypeScript Support

This package includes TypeScript type definitions for the Guesty Tokenization JS SDK. This includes types for the window.guestyTokenization namespace. We support projects using TypeScript versions >= 3.8.

版本与发布记录

@guestyorg/tokenization-js 共发布 9 个版本,首次发布于 2023/09/14;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.2.0latest2026/09/022 个月前
1.1.12024/10/102 年前
1.1.02024/10/092 年前
1.0.42024/08/062 年前
1.0.32024/06/032 年前
1.0.22024/03/182 年前

关于 @guestyorg/tokenization-js 的常见问题

@guestyorg/tokenization-js 是什么?

Guesty Tokenization SDK loading utility and types

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