更新日志
状态页面Dashboard预约演示
开始键入搜索...
返回全部

Lite Web SDK v1.2 更新日志

3个月前，Damian Furfuro
  • 发布日期发布日期： 2025 年 4 月
  • 状态：上一版本（被 v1.3 取代）

v1.2 中的新功能

1.2版在精简版v1.1的基础上，增强了支付流程控制能力，并大幅扩展了国际语言支持。

增强型 continuePayment 方法

扩展功能支持在支付流程中动态调整配置，从而实现更灵活的部署方案。

  1. 扩展 continuePayment 功能性:从 1.2.0 版开始，该系统将使用 continuePayment 方法现在可以接受以前只能在 startCheckout.这样您就可以在继续付款时覆盖特定配置。

新 continuePayment 属性

完整的配置选项列表现在可在 continuePayment:

continuePayment({
  checkoutSession?: string
  showPaymentStatus?: boolean
  yunoPaymentResult?: (status: string) => void
  yunoError?: (message: string, data?: unknown) => void
  countryCode?: string
  language?: string
})

增强参数：

  • checkoutSession:覆盖当前付款的结账会话
  • showPaymentStatus:控制是否显示 Yuno 支付状态页面
  • yunoPaymentResult:用于处理付款结果的自定义回调
  • yunoError:自定义错误处理回调
  • countryCode:在继续付款时指定国家代码
  • language在支付继续过程中设置语言偏好

扩展语言支持

为全球Lite SDK 显著扩展了国际语言支持范围：

  • 核心语言：西班牙语（es）、葡萄牙语（pt）、印度尼西亚语（id）、马来语（ms）、泰语（th）
  • 亚洲语言：菲律宾语 (fil)、繁体中文 (zh-TW)、简体中文 (zh-CN)、越南语 (vi)、韩语 (ko)、日语 (ja)
  • 欧洲语言：法语 (fr)、波兰语 (pl)、意大利语 (it)、德语 (de)、俄语 (ru)、土耳其语 (tr)、荷兰语 (nl)、瑞典语 (sv)

实施方面的变化

Lite v1.2 实施与迁移的重要注意事项。

与 v1.1 相比的主要变化

  • 增强型 continuePayment:方法现在可接受配置重写
  • 扩展的语言选项：支持18种语言，而v1.1版本仅支持7种语言
  • 向后兼容性：仍支持所有 1.1 版功能

脚本标签

更新了脚本源以实现 v1.2 功能：

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

使用示例

展示增强的 continuePayment Lite SDK SDK中的功能：

// Enhanced continuePayment with configuration override
yuno.continuePayment({
  checkoutSession: "438413b7-4921-41e4-b8f3-28a5a0141638",
  showPaymentStatus: true,
  yunoPaymentResult: (status) => {
    console.log("Payment completed with status:", status);
  },
  yunoError: (message, data) => {
    console.error("Payment error:", message, data);
  },
  countryCode: "US",
  language: "en"
});

完整实现示例

Full Lite v1.2 实现版本展示增强功能：

// Lite v1.2 implementation with enhanced continuePayment
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);
  },
});

// Enhanced continuePayment with overrides
if (paymentResponse.sdk_action_required) {
  const result = await yuno.continuePayment({
    countryCode: "DE",
    language: "de",
    showPaymentStatus: false,
    yunoPaymentResult: (status) => {
      console.log("Payment continued with result:", status);
    }
  });
}

从 v1.1 迁移

从 Lite v1.1 版本开始，升级路径平滑，且不存在破坏性变更。

从精简版 v1.1 升级至 v1.2：

  1. 将脚本源代码更新至 v1.2
  2. 可选择利用新的 continuePayment 加强控制的参数
  3. 充分利用扩展的语言支持，以满足国际化实施需求
  4. 无破坏性更改--现有实施方案继续运行

迁移时间线

  • 沙盒：自 2025 年 6 月 5 日起生效的变更
  • 生产：更改自 2025 年 9 月 5 日起生效

已废弃的内容

完全向后兼容的版本，没有过时的功能。

在精简版 v1.2 中，没有任何功能被废弃。所有先前功能均仍可使用并获得支持。

Lite SDK 优势

Lite Web SDK .2 在保持精简设计的同时，新增了强大功能：

  • 简化复杂性：增强功能，无需繁琐配置选项
  • 全球覆盖：为国际市场扩展语言支持
  • 灵活的流程:增强型 continuePayment 适用于动态支付场景
  • 轻松迁移：从v1.1版本开始的向后兼容升级
📘

Lite SDK 焦点

Lite Web SDK .2继续提供核心支付功能，并增强了多项能力。对于需要更高级功能或定制选项的商家，建议考虑 Full Web SDK 以获取全面的支付处理解决方案。

📘

其他资源

有关实施指南和示例，请访问Lite Web SDK 和GitHub 存储库以获取更多信息。