Lite Web SDK v1.1 更新日志

发布日期2025 年初
状态：上一版本（被 v1.2 取代）

v1.1 中的新功能

Yuno 的Lite Web SDK 首次发布，以简化的实施方法推出了精简的支付集成功能，非常适合寻求快速高效支付处理的商家，同时又避免了全功能解决方案的复杂性。

首次发布

YunoLite Web SDK 的基础版本，以简化的集成模式提供基本的支付处理功能。

核心Lite SDK 功能

Yuno Lite v1.1 采用精简的方法，专注于基本支付功能：

简化集成：简化设置流程，快速实施
基本支付方式：支持核心支付方式，无需过多选项
支持异步方法：为现代 JavaScript 框架提供基于承诺的操作
基本回调：支付流程管理的关键事件处理

支持付款方式

基本支付方式覆盖范围，可简化实施工作：

信用卡和借记卡
数字钱包（贝宝、苹果支付、谷歌支付）
银行转账和直接借记
按地区分列的当地付款方式
多种货币和国家

整合方法

简化实施方案，实现快速部署：

HTML 脚本标签：包含简单脚本，可快速设置
动态 JavaScript：高级配置的程序化加载
NPM 模块：现代 JavaScript 框架集成支持

多语言支持

初步提供七种核心语言的国际支持：

西班牙语 (es)
英语 (en)
葡萄牙语 (pt)
菲律宾语 (fil)
印度尼西亚语（id）
马来语（毫秒）
泰语

实施

脚本标签

使用标准 HTML 脚本标签进行简单集成：

<script src="https://sdk-web.y.uno/v1.1/main.js"></script>

基本用法

Lite v1.1 的标准异步初始化和检出流程：

// Lite v1.1 async initialization
const yuno = await Yuno.initialize(PUBLIC_API_KEY)

yuno.startCheckout({
  checkoutSession: "438413b7-4921-41e4-b8f3-28a5a0141638",
  elementSelector: "#root",
  countryCode: "FR",
  language: "fr",
  showLoading: true,
  issuersFormEnable: true,
  showPaymentStatus: true,
  card: {
    isCreditCardProcessingOnly: true,
  },
  onLoading: (args) => {
    console.log(args);
  },
  yunoPaymentResult: (status) => {
    console.log("Payment result:", status);
  },
  yunoError: (message, data) => {
    console.error("Payment error:", message, data);
  },
});

主要方法

Lite v1.1 初始版本中提供的核心方法：

Yuno.initialize():使用公共 API 密钥Initialize SDK
startCheckout():开始配置付款流程
基本回调: onLoading, yunoPaymentResult, yunoError

基本参数

Lite SDK 实现所需的参数和主要可选参数：

参数	说明
`checkoutSession`	指当前付款的结账会话
`elementSelector`	安装 SDK 的元素
`countryCode`	确定付款配置的国家
`language`	定义付款表格的语言
`showLoading`	控制 Yuno 载入/旋转器页面的可见性
`issuersFormEnable`	使发行人的表格
`showPaymentStatus`	显示 Yuno 支付状态页面
`card.isCreditCardProcessingOnly`	确保所有银行卡交易仅作为贷记处理

已废弃的内容

这是初始版本--推出时没有过时的功能。

迁移说明

来自Full Web SDK

如果从full Web SDK 迁移到精简版：

将脚本源更新为 Lite v1.1 版本的 URL
删除不需要的高级功能，简化实施过程
确保所有方法调用都使用 Lite v1.1 API 签名
在沙箱环境中彻底测试支付流程

展望未来

虽然 Lite v1.1 简化了功能，但请注意：

v1.2 引入了增强的continuePayment：未来版本将添加改进的继续付款方法
扩展语言支持：后续版本将增加更多国际语言
更多配置选项：未来版本将提供更多定制功能

有关最新信息，请始终参考最新的Lite SDK 文档，并考虑为未来的版本迁移做好规划。

📘
Lite SDK 焦点
Lite Web SDK 需要基本支付功能而不需要复杂高级功能的商家设计。如果您需要更多定制选项或高级支付流程，请考虑使用 Full Web SDK来代替。