Changelog
Status PageDashboardBook a Demo
Start typing to search…
Back to All

Web SDK v1.5 Changelog

3 days ago by Damian Furfuro
  • Release Date: Latest Version
  • Status: Current production version

What's New in v1.5

This version introduces improved Google Pay and Apple Pay button rendering with greater flexibility for merchants to control button placement and display.

Google Pay and Apple Pay Display Update

Enhanced button rendering for digital wallet payment methods with improved UI control.

  1. Direct Button Display: Google Pay and Apple Pay now appear as direct buttons instead of radio buttons within the payment methods list. These buttons are displayed separately from other payment methods, providing a cleaner and more prominent checkout experience.

New Methods and Capabilities

Greater control over digital wallet button placement and management.

  1. New Method: mountExternalButtons: Added a new method that allows merchants to render Google Pay and Apple Pay buttons in custom locations within their UI. This provides complete control over button placement and styling.

  2. Button Unmounting Methods: Added methods to unmount external buttons:

    • unmountExternalButton(paymentMethodType): Unmount a single external button
    • unmountAllExternalButtons(): Unmount all external buttons at once

Lite SDK Changes

Updated Lite SDK behavior for digital wallet integrations.

  1. Lite SDK Restrictions: In the Lite version of the SDK, Google Pay and Apple Pay are no longer available as built-in payment options. Merchants must use the new mountExternalButtons method to display these payment methods.

User Experience Improvements

Enhanced enrollment and payment flows for a smoother checkout experience.

  1. PayPal Enrollment UX Improvement: The PayPal enrollment flow in SDK Lite and Full SDK has been streamlined. When customers select PayPal for enrollment, the PayPal payment sheet now opens immediately after selection, removing the extra confirmation step. This provides a faster, more seamless enrollment experience.

  2. PayPal Payment UX Improvement: The PayPal payment flow in SDK Lite and Full SDK has been streamlined. When customers select PayPal as their payment method, the PayPal payment sheet now opens immediately after selection, removing the extra confirmation step. This provides a faster, more seamless checkout experience.

Implementation

Complete backward compatibility for Full SDK implementations. Lite SDK requires code changes to use mountExternalButtons for Google Pay and Apple Pay.

📘

Current Version Implementation

For complete implementation instructions using v1.5, visit the Web SDK documentation.

Key Changes from v1.4

  • No breaking changes for Full SDK: v1.5 is fully backward compatible for Full SDK implementations
  • Lite SDK changes: Google Pay and Apple Pay now require mountExternalButtons method
  • New method: mountExternalButtons available for custom button placement
  • UI improvements: Google Pay and Apple Pay buttons displayed as direct buttons instead of radio buttons
  • PayPal enrollment UX: Streamlined PayPal enrollment flow with immediate sheet opening after selection
  • PayPal payment UX: Streamlined PayPal payment flow with immediate sheet opening after selection

Script Tag Update

Latest script source for v1.5 features and improvements:

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

mountExternalButtons Example

Render Google Pay and Apple Pay buttons in custom locations:

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',
  },
]);

Unmounting Buttons Example

Unmount a single external button:

yuno.unmountExternalButton('APPLE_PAY');

Or unmount all external buttons at once:

yuno.unmountAllExternalButtons();

Migration from v1.4

Seamless upgrade process for Full SDK with no breaking changes. Lite SDK requires code updates for Google Pay and Apple Pay.

Full SDK Migration

Upgrading from v1.4 to v1.5 requires minimal changes:

  1. Update your script source to point to v1.5
  2. No code changes required for existing implementations
  3. Google Pay and Apple Pay will automatically display as direct buttons instead of radio buttons

Lite SDK Migration

If you're using Lite SDK and want to continue offering Google Pay and Apple Pay:

  1. Update your script source to point to v1.5
  2. Add the mountExternalButtons method call after startCheckout
  3. Create HTML elements where you want the buttons to appear (e.g., <div id="apple-pay"></div>)
  4. Use mountExternalButtons to render the buttons in your chosen locations

Example migration for Lite SDK:

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

What's Deprecated

Fully backward compatible release maintaining all existing functionality.

No features were deprecated in v1.5. All previous functionality remains available and supported. The change in Google Pay and Apple Pay display (from radio buttons to direct buttons) is a UI improvement and does not affect functionality.