网络 SDK v1.0 更新日志

发布日期2025 年初
状态：原始版本（被 v1.1 取代）

v1.0 中的新功能

Yuno Web SDK 的初始版本引入了全面的支付集成功能，支持多种 SDK 类型、支付方式和集成方法。

首次发布

Yuno Web SDK的基础版本，提供适用于不同集成模式的完整支付处理功能。

核心 SDK 功能

Yuno v1.0 包括四种不同的 SDK 方法，以满足不同的集成需求：

完整的结账 SDK：具有多种付款方式和完整用户界面的完整付款表单
Lite Checkout SDK：简化支付流程，实现更简单的集成
Seamless SDK：可定制的支付组件，打造品牌化体验
Headless SDK：面向自定义UI实现的API优先方法

支持付款方式

全面支持全球和地区支付方式：

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

整合方法

灵活的实施选项，适合不同的开发工作流程：

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

多语言支持

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

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

实施

脚本标签

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

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

基本用法

v1.0 的标准同步初始化和检出过程：

// v1.0 synchronous initialization
const yuno = Yuno.initialize(PUBLIC_API_KEY)

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

主要方法

在最初的 v1.0 版本中提供的核心方法：

Yuno.initialize():使用公共 API 密钥Initialize SDK
startCheckout():开始配置付款流程
mountCheckout():将支付表单安装到指定的 DOM 元素
startPayment():选择客户后启动付款流程

已废弃的内容

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

迁移说明

早期测试版本

如果从任何预发布版本或测试版升级：

更新脚本源代码至稳定版 v1.0 发布的 URL
确保所有方法调用都使用最终的 v1.0 API 签名
验证签出会话的创建是否遵循稳定的 API 格式
在沙箱环境中彻底测试支付流程

展望未来

虽然 v1.0 版提供了坚实的基础，但请注意：

v1.1 引入了异步方法：未来版本将转向基于承诺的应用程序接口
增强付款流程：后续版本将增加经改进的付款延续方法
3DS 集成更改：未来版本将简化 3DS 的设置和操作

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