使用说明

CDN地址

https://checkout.subotiz.com/static/subotiz/v0/subotiz.js

SDK实例化

通过以下代码完成SDK实例创建：

const subotiz = window.Subotiz()

初始化嵌入式Checkout

此方法用于初始化嵌入式Checkout支付组件，返回Checkout实例。

方法调用示例

const checkout = await subotiz.initEmbeddedCheckout({
    fetchSessionUrl: async() =>{
        // 从服务端获取sessionURL示例
        const response = await fetch('/api/session');
        const data = await response.json();
        return data.sessionUrl;
    },
    environment: 'SANDBOX',  // 'SANDBOX' | 'PRODUCTION'
    
});

参数说明

Options (必传) object类型

属性	类型	必填	默认值	描述
fetchSessionId	`()=>Promise<string>`	否		回调函数 `fetchClientSecret() => Promise<string>` 获取 Checkout Session id。 `fetchSessionId`与`fetchSessionUrl`必须要提供⼀个，同时提供时仅调⽤`fetchSessionId`
fetchSessionUrl	`()=>Promise<string>`	否		回调函数 `fetchClientSecret() => Promise<string>` 获取 Checkout Session URL。 `fetchSessionId`与`fetchSessionUrl`必须要提供⼀个，同时提供时仅调⽤`fetchSessionId`
environment	'SANDBOX' ｜ 'PRODUCTION'	否	'SANDBOX'	当前环境设置 'SANDBOX' - 沙盒环境（默认值） 'PRODUCTION' - 生产环境
onComplete	()=>void	否		支付完成时的回调函数仅在创建Checkout Session时将`redirect_on_completion` 设置为 `if_required` 时触发，即用户不接受自动重定向时触发该回调

挂载Checkout组件

需先创建容器DOM元素，再将Checkout组件挂载到该容器中。

操作示例

<!-- 创建容器 -->
<div id="your_domElement">
  <!-- Checkout组件将在此处显示 -->
</div>

<script>
  // 挂载组件
  checkout.mount('#your_domElement');
</script>

参数说明

selector 必传 string类型，容器元素的CSS选择器（如#your_domElement）

卸载Checkout组件

从DOM中卸载已挂载的Checkout组件，后续可通过mount重新挂载。

checkout.unmount();