Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

Migrating to Web SDK v1.5

Version 1.5.0 changes how Google Pay and Apple Pay are rendered in the Lite SDK. Full SDK integrations are not affected.

What changed

In v1.5.0, Lite SDK users must explicitly call mountExternalButtons() to render Google Pay and Apple Pay buttons. These payment methods no longer render automatically as radio buttons within the payment method list. Full SDK integrations have no breaking changes — Google Pay and Apple Pay will automatically display as direct buttons instead of radio buttons, requiring no code changes.

Who is affected

  • Lite SDK users: action required (see steps below)
  • Full SDK users: no action required

Steps (Lite SDK only)

1. Update the script tag

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

2. Add HTML elements for wallet buttons

Add container elements in your HTML where you want the buttons to appear:
<div id="apple-pay"></div>
<div id="google-pay"></div>

3. Call mountExternalButtons() after startCheckout

Before:
// Lite SDK — wallet buttons rendered automatically
await yuno.startCheckout({ checkoutSession, countryCode, elementSelector: '#root' })
After:
// Explicitly mount wallet buttons after startCheckout
await yuno.startCheckout({ checkoutSession, countryCode, elementSelector: '#root' })

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

4. (Optional) Unmount buttons when needed

To unmount a single button:
yuno.unmountExternalButton('APPLE_PAY')
To unmount all external buttons at once:
yuno.unmountAllExternalButtons()