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

网络 SDK v1.1 更新日志

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

v1.1 中的新功能

1.1 版是 Yuno Web SDK 的重大演进，引入了异步操作，增强了支付流程，并显著提高了现代网络应用程序的性能。

异步方法更新

关键 SDK 方法现在支持基于 Promise 的操作，以便更好地与现代 JavaScript 框架集成。

  1. 基于承诺的方法:主要方法，如 initialize(), mountCheckout()和 startCheckout() 现在返回承诺。这一变更支持更好地处理 3DS、PayPal 重定向和自定义用户界面呈现等动态流程。
// v1.1 async implementation
const yuno = await Yuno.initialize(PUBLIC_API_KEY)

增强型 continuePayment 方法

"(《世界人权宣言》) continuePayment 这种方法对于处理复杂的付款流程和确保完成付款至关重要。

  1. 关键付款延续:随着 SDK v1.1 引入新的支付方式和动态流量，用户可以 continuePayment 在创建付款后，这种方法对于完成客户付款体验变得更加重要。

    • 何时使用:当 API 响应包括 sdk_action_required: true您必须调用 continuePayment 恢复进程
    • 自动处理：SDK 自动渲染必要的屏幕（3DS 身份验证、外部钱包步骤）
    • 返回行为:可能返回一个重定向对象供商家处理，否则返回 null

3DS 增强功能（2025 年 6 月 5 日）

精简 3DS 验证流程，提高可靠性，简化集成要求。

  1. 简化 3DS 集成：更新了 3DS 流程，以提高可靠性并简化集成：

    • 无需单独设置服务：3DS 数据收集和设置现已包含在付款创建中
    • 异步交易：所有 3DS 事务都使用重定向来获取设备信息和挑战
    • 所需实施:必须执行 continuePayment() 和 yunoPaymentResult() 创建付款后
    • 性能优化:SDK 触发器 collect 只在需要 3DS 时进行

性能改进

针对所有SDK操作进行全面优化，实现更快、更可靠的支付处理。

  1. 优化流程:
    • 减少不必要的 API 调用
    • 提高整体性能
    • 更好的视觉一致性
    • 增强的安全功能

点击付费 (C2P) 动态行为

改进了点击付费功能，增强了用户体验和动态行为支持。

  1. 增强型 C2P:全面改进点击付费功能：
    • 根据卡片动态更新条款和条件以及徽标
    • 隐藏不支持的 C2P 选项
    • 为注册添加电话号码字段
    • 的合规性设置 privacy 和 tnc (条款和条件)现在随卡一起传递

增强用户界面

大幅改进支付表单设计和用户体验。

  1. 注册卡可视化改进：

    • 威士卡和万事达卡的通用卡视觉效果现已出现
    • 美国运通卡正面显示 CVV
    • 根据 CVV 字段焦点动态翻转卡片视觉效果
    • 动态标题适应用户输入的内容
    • 重新设计分期付款选择器，改善手机和桌面的用户体验
    • 跨平台的风格和行为保持一致

  2. 布局改进：

    • 纠正了文件类型和分期付款字段之间的重叠
    • 现在可在验证过程中适当调整布局

  3. 预选付款方式：

    • 自动预选上次使用的付款方式（或首次配置的付款方式）
    • 无差错处理无效或已删除的方法

  4. 注册付款方式管理：

    • 用户现在可以直接在 SDK 界面中删除已保存的付款方式

  5. 内联卡输入：

    • 用户现在可以直接在 "卡 "选项下方输入卡的详细信息
    • 与分期付款和卡片选择器等现有流程完全兼容
    • 切换方法时字段保持不变

技术改进

增强后台和集成功能，提高可靠性和功能性。

  1. PayPal 后备客户端 ID：

    • 当 PayPal clientId 如果商家配置中没有提供"......"，SDK 就会使用来自 paymentByCheckoutSession endpoint 响应

  2. 灵活的结账风格：

    • 灵活的操作元素现在支持通过 UI 对象中的 getPaymentByCheckout 回应
    • 确保跨平台和跨设备设计的一致性

  3. 删除过时的字段：

    • 删除了未使用的 gender 字段和必填字段配置

  4. 状态屏幕更新：

    • 增强了所有状态屏幕的视觉效果，使外观更简洁

安全性和付款方式的改进

新的安全集成和扩展的支付方式支持。

  1. 新的安全集成：

    • Airwallex：为网络增加一个额外的安全层
    • Forter（网络）：借助 Forter 的防欺诈技术加强支付保护
    • 结账 3DS:支持新的 3D 安全提供程序。当交易提供商为 checkout3ds
    • 无限 3DS：为 "Unlimit "支付引入 3DS 支持，增强了身份验证和欺诈防范功能

  2. 巴西付款改进：

    • 混合卡：现在默认作为信用卡处理，提高了巴西商户的转换率
    • 新的 Boleto 支付方式：Boleto Bancário 现在适用于在巴西经营的所有商户，扩大了本地支付选择，提高了偏好离线方式的用户的转换率

实施方面的变化

需要更新现有集成的重大架构变更。

与版本 1.0 相比的重大变更

  • 异步方法:所有主要方法现在都返回承诺，并要求 await
  • continuePayment 重要性:现在对付款完成流程至关重要
  • 3DS 流程更改：不再需要单独设置 3DS

脚本标签

为 v1.1 版更新了脚本源，采用了新的 URL 结构：

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

迁移示例

比较显示了 v1.0 和 v1.1 实现之间的主要差异：

// v1.0 (synchronous)
const yuno = Yuno.initialize(PUBLIC_API_KEY);
yuno.startCheckout(config);

// v1.1 (asynchronous) 
const yuno = await Yuno.initialize(PUBLIC_API_KEY);
await yuno.startCheckout(config);

// Essential: Implement continuePayment for dynamic flows
if (paymentResponse.sdk_action_required) {
  const result = await yuno.continuePayment();
  // Handle result appropriately
}

从 v1.0 迁移

将现有的 v1.0 实施升级到 v1.1 的基本步骤。

所需的更改：

  1. 将脚本源代码更新至 v1.1
  2. 添加 await 至 initialize(), mountCheckout()和 startCheckout() 电话
  3. 实施 continuePayment() 处理动态付款流
  4. 确保 yunoPaymentResult() 回调已正确配置
  5. 删除任何单独的 3DS 设置服务调用

时间轴

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

其他资源

有关实施指南和示例，请访问Web SDK 文档页面和GitHub 存储库了解更多信息。

V1.1 过时的内容

1.1 版中不再推荐或支持的功能和模式。

  • 单独的 3DS 设置服务：不再需要；集成到付款创建中
  • 同步方法调用:方法现在返回承诺，并应使用 await
  • 手动处理 3DS：SDK 现在可自动处理 3DS 流程