JS SDK 客串化
融合SDK有两种方法:
手动包含脚本标签
在您的应用程序中添加脚本标签 head 或者说 body。 。 。 .
此负载 guestyTokenization 全局对象 window 浏览器范围
<script src="https://pay.guesty.com/tokenization/v3/init.js"></script>
用它作为ES模块
将 SDK 装入模块的好处 :
- 同步加载脚本以确保页面渲染不被屏蔽
- 返回一个承诺,以知道脚本装入何时完成
- 决定:
null如果在服务器环境中调用
注意: 要符合PCI, 您必须直接装入 SDK https://pay.guesty.com (英语) (或者通过添加脚本标记或者使用ES模块). 你不能把它包含在一个捆绑或主机.
安装
使用 npm 安装Guesty Tokenization JS模块:
npm install @guestyorg/tokenization-js
使用量
导入 loadScript 用于同步装入 Guesty Tokenization JS SDK 的功能
加载脚本( 选项 )
- 接受一个
options对象以配置脚本 URL 和属性 - 返回以
window.guestyTokenizationsDK 装入完成后
选项
sandbox- 把SDK装入沙盒模式version- 要装入的 SDK 版本( 默认 ):v1) (中文(简体) ). 支持的数值 :v1, (中文(简体) ),v2, (中文(简体) ),v3
loadScript({ sandbox: true, version: 'v3' });
这相当于以下剧本:
<script
src="https://pay.guesty.com/tokenization/v3/init.js"
data-env="sandbox"
></script>
自动/等待
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);
}
承诺
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 的项目.