Web SDK v1.5 变更日志

发布日期：最新版本
状态当前生产版本

v1.5版本新增内容

此版本引入了改进的Google Pay和Apple Pay按钮渲染功能，为商家提供了更大的灵活性来控制按钮的位置和显示效果。

Google Pay 和 Apple Pay 显示更新

针对数字钱包支付方式增强按钮渲染效果，并优化用户界面控制。

直接按钮显示：Google Pay和Apple Pay现以直接按钮形式呈现，而非支付方式列表中的单选按钮。这些按钮与其他支付方式分开显示，提供更简洁醒目的结账体验。

新方法与新能力

对数字钱包按钮位置的放置与管理实现更全面的控制。

新方法： mountExternalButtons新增了一项功能，允许商家在用户界面中的自定义位置显示Google Pay和Apple Pay按钮。这为按钮的位置和样式提供了完全的控制权。
按钮卸载方法：新增用于卸载外部按钮的方法：
- unmountExternalButton(paymentMethodType)卸载单个外部按钮
- unmountAllExternalButtons(): 同时卸载所有外部按钮

Lite SDK

更新了数字钱包集成中Lite SDK 。

Lite SDK在SDK精简版中，Google Pay和Apple Pay不再作为内置支付选项提供。商家必须使用新的 mountExternalButtons 显示这些支付方式的方法。

用户体验改进

优化注册与支付流程，打造更顺畅的结账体验。

PayPal注册流程用户体验优化：SDK Lite和Full SDK 中的PayPal注册流程Full SDK 简化。当客户选择PayPal进行注册时，PayPal支付页面将在选定后立即弹出，省去额外的确认步骤。这将提供更快速、更流畅的注册体验。
PayPal支付用户体验优化：SDK Lite和Full SDK 中的PayPal支付流程Full SDK 简化。当客户选择PayPal作为支付方式时，PayPal支付页面将在选定后立即弹出，省去额外的确认步骤。这将提供更快速、更流畅的结账体验。

实施

完整向后兼容性适用于Full SDK 。Lite SDK 修改代码才能使用。 mountExternalButtons 适用于Google Pay和Apple Pay。

📘
当前版本的实施
要获取使用v1.5的完整实施说明，请访问Web SDK文档。

相较于v1.4版本的主要变更

Full SDK无破坏性变更：v1.5版本对 Full SDK 完全向后兼容
Lite SDKGoogle Pay 和 Apple Pay 现要求 mountExternalButtons 方法
新方法: mountExternalButtons 可自定义按钮位置
用户界面改进：Google Pay和Apple Pay按钮以直接按钮形式显示，而非单选按钮
PayPal注册用户体验：优化注册流程，选项确认后立即打开注册表单
PayPal支付用户体验：优化支付流程，选定后即时弹出支付窗口

脚本标签更新

v1.5版本功能与改进的最新脚本源代码：

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

mountExternalButtons 示例

在自定义位置显示Google Pay和Apple Pay按钮：

const yuno = await window.Yuno.initialize(publicApiKey);

await yuno.startCheckout({
  checkoutSession,
  elementSelector: '#root',
  countryCode: 'US',
  language: 'en',
  // ... other configuration
});

// Mount external buttons
await yuno.mountExternalButtons([
  {
    paymentMethodType: 'APPLE_PAY',
    elementSelector: '#apple-pay',
  },
  {
    paymentMethodType: 'GOOGLE_PAY',
    elementSelector: '#google-pay',
  },
]);

卸载按钮示例

卸载单个外部按钮：

yuno.unmountExternalButton('APPLE_PAY')；

或者一次性卸载所有外部按钮：

yuno.unmountAllExternalButtons()；

从v1.4迁移

Full SDK 提供无缝升级流程Full SDK 不存在破坏性变更。Lite SDK 针对Google Pay和Apple PayLite SDK 代码更新。

Full SDK

从v1.4升级到v1.5只需进行最小的更改：

更新您的脚本源以指向v1.5版本
无需更改现有实施的代码
Google Pay 和 Apple Pay 将自动显示为直接按钮，而非单选按钮。

Lite SDK

若您正在使用Lite SDK 希望继续提供Google Pay和Apple Pay服务：

更新您的脚本源以指向v1.5版本
添加 mountExternalButtons 方法调用之后 startCheckout
在需要显示按钮的位置创建HTML元素（例如： <div id="apple-pay"></div>)
使用 mountExternalButtons 在您选择的位置呈现按钮

Lite SDK 的迁移示例：

// After startCheckout
await yuno.mountExternalButtons([
  {
    paymentMethodType: 'APPLE_PAY',
    elementSelector: '#apple-pay',
  },
  {
    paymentMethodType: 'GOOGLE_PAY',
    elementSelector: '#google-pay',
  },
]);

已废弃的内容

完全向后兼容的版本，保留所有现有功能。

v1.5版本中未废弃任何功能。所有先前功能均保持可用且受支持。Google Pay和Apple Pay显示方式的变更（从单选按钮改为直接按钮）属于用户界面改进，不影响功能使用。