网络 SDK v1.2 更新日志

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

v1.2 中的新功能

1.2 版在 1.1 版的基础上增强了定制选项和支付流程控制功能。

高级初始化选项

新的初始化参数为复杂的实现提供了对 SDK 行为的更大控制。

可选 options 参数:支持可选的 options 中的参数 Yuno.initialize，让您可以对 SDK 行为进行更多控制。该新增功能适用于具有高级用例或自定义会话和跟踪要求的团队。

增强型 `continuePayment` 方法

扩展功能允许在继续付款时动态更改配置。

扩展 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在支付继续过程中设置语言偏好

语言支持

为全球实施显著扩展了国际语言覆盖范围：

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

实施说明

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

与 v1.1 相比的主要变化

增强型 continuePayment:方法现在可接受配置重写
高级初始化：自定义行为的可选参数
向后兼容性：仍支持所有 1.1 版功能

脚本标签

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

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

使用示例

展示增强的 continuePayment 能力：

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

从 v1.1 迁移

升级路径顺畅，与 1.1 版相比没有任何破坏性改动。

从 v1.1 升级到 v1.2：

将脚本源代码更新至 v1.2
可选择利用新的 continuePayment 加强控制的参数
考虑在高级用例中使用可选初始化参数
无破坏性更改--现有实施方案继续运行

已废弃的内容

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

V1.2 中没有废弃的功能。之前的所有功能仍然可用并受支持。