Web SDK Changelog

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.

​

v1.6.8

• unMountSdk() Helper
  Introduced a new top-level unMountSdk() method for explicit SDK cleanup. Call it when removing the SDK from the page to avoid memory leaks.

yuno.unmountSdk();

• Rollback Cancel Flow
  Unified cancel flow events. The SDK now explicitly reports CANCELED_BY_USER in the yunoPaymentResult callback for all cancellation scenarios.
• Legacy Event Rollback
  Legacy cancel-related events have been consolidated into the standard result flow. No new API changes required.
• Forter Token Listener
  Added a listener for the ftr:tokenReady event to ensure reliable capture of the Forter session token. Previously the token could be missed on slow page loads.

• Metadata Support
  The cancel flow now includes a metadata parameter with a paymentCreated boolean, letting merchants determine whether a payment object was created before cancellation.
• Contact Info Passthrough
  The SDK now automatically collects and forwards the customer’s email, phone, and name from shippingContact. No configuration required.

• No OTT Flow
  Added support for a REDIRECT workflow that skips OTT creation, enabling PayPal payments without a prior server-side session.

yuno.startSeamlessCheckout({
  paypal: {
    workflow: 'REDIRECT',
    orderId: 'YOUR_PAYPAL_ORDER_ID',
  }
});

• PayPal Button Modal
  New PaypalButtonModal component that renders the PayPal button inside a modal overlay, useful for merchants using a custom checkout UI.

​

v1.6.0

• Subresource Integrity Support
  The SDK script tag now supports the integrity attribute for SRI-compliant loading, preventing unauthorized code injection. The @yuno-payments/sdk-web npm package exposes a loadScript method for SRI-compliant dynamic loading.

<script
  src="https://sdk-web.y.uno/v1.6/main.js"
  integrity="sha384-..."
  crossorigin="anonymous"
></script>

• Arabic Language and RTL Layout
  Added Arabic (ar) language support. The checkout UI automatically switches to a Right-to-Left layout when Arabic is selected — no extra configuration required.

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

await yuno.startCheckout({
  checkoutSession,
  elementSelector: '#root',
  countryCode: 'AE',
  language: 'ar',
});

• Faster Initialization
  Improved initialization performance for both Lite and Full SDKs, reducing time-to-interactive on first load.
• Detailed Error Codes
  Configuration errors now surface more descriptive error codes, making it easier to diagnose integration issues during development.
• 3DS Modal Centering
  Fixed an issue where the 3DS challenge modal was not centered on mobile devices. The modal now correctly fills and centers within the viewport.

​

v1.5.0

• mountExternalButtons Method
  New mountExternalButtons(buttons) method lets merchants render Google Pay and Apple Pay buttons in any custom location within their UI, providing full control over button placement and styling.

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

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

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

• Button Unmounting Methods
  Added unmountExternalButton(paymentMethodType) to remove a single external wallet button and unmountAllExternalButtons() to remove all mounted wallet buttons at once.

// Remove a single button
yuno.unmountExternalButton('APPLE_PAY');

// Remove all buttons
yuno.unmountAllExternalButtons();

• Wallet Buttons as Direct Buttons
  Google Pay and Apple Pay now appear as direct action buttons instead of radio-button list items, providing a cleaner and more prominent placement in the checkout UI.
• PayPal Enrollment UX
  The PayPal payment sheet now opens immediately after the customer selects PayPal for enrollment or payment, removing an extra confirmation step for a faster checkout experience.

• Lite SDK External Buttons Required
  Google Pay and Apple Pay in the Lite Web SDK now require explicit mounting via mountExternalButtons(). Previously they rendered automatically as radio buttons. Lite SDK integrations must add a mountExternalButtons call — Full SDK integrations are not affected.
  Migration guide →

​

v1.4.0

• Card Payment Voucher Messages
  Added voucher messaging for card payments, giving customers clear confirmation and transaction details immediately after a successful payment.
• Language Override for Loader
  The Yuno loader now accepts a language property, allowing explicit UI language control independent of browser settings. Useful for multi-language environments.

Yuno.initialize({
  language: 'es',
});

• Enhanced Click-to-Pay Rendering
  Improved rendering support for Click-to-Pay (C2P) elements, streamlining the checkout experience for enrolled cards.

• PayPal Installments Enrollment
  Customers can now enroll in PayPal installment plans directly through the PayPal payment flow, providing flexible payment options at checkout.
• PayPal External Button Redirect
  PayPal can now be integrated via redirect flow with external buttons, giving merchants greater flexibility in building their payment UI.

​

v1.3.0

• Smart Payment Method Grouping
  When a customer has an enrolled payment method, all other available methods are grouped under a collapsible “More options” dropdown. The enrolled method is prominently displayed by default.
• European and Asian Language Support
  Added support for German (de), Dutch (nl), Swedish (sv), French (fr), Italian (it), Japanese (ja), and Korean (ko). Pass the corresponding code via the language initialization parameter.
• General Bug Fixes
  Resolved various stability issues to improve reliability across payment flows.
• Enhanced Styling and Branding
  Improved visual consistency and expanded customization options across checkout components.

​

v1.2.0

• Optional Initialization Options
  Added an optional options parameter to Yuno.initialize for teams with advanced use cases such as custom session handling or tracking requirements.
• Extended continuePayment Parameters
  continuePayment now accepts checkoutSession, showPaymentStatus, yunoPaymentResult, yunoError, countryCode, and language, allowing configuration overrides during payment continuation without restarting the checkout.

yuno.continuePayment({
  checkoutSession: '438413b7-4921-41e4-b8f3-28a5a0141638',
  showPaymentStatus: true,
  yunoPaymentResult: (status) => {
    console.log('Payment completed with status:', status);
  },
  yunoError: (message, data) => {
    console.error('Payment error:', message, data);
  },
  countryCode: 'US',
  language: 'en',
});

• 21+ Language Support
  Expanded language coverage to over 21 locales including Chinese Simplified (zh-CN), Chinese Traditional (zh-TW), Vietnamese (vi), Russian (ru), Turkish (tr), Polish (pl), and more. Pass the language code to the language parameter in startCheckout.

• Lite SDK continuePayment Overrides
  The Lite SDK continuePayment method now accepts the same configuration overrides available in the Full SDK, enabling dynamic session, language, and callback changes during payment continuation.

if (paymentResponse.sdk_action_required) {
  await yuno.continuePayment({
    countryCode: 'DE',
    language: 'de',
    showPaymentStatus: false,
    yunoPaymentResult: (status) => {
      console.log('Payment continued with result:', status);
    },
    yunoError: (message, data) => {
      console.error('Payment error:', message, data);
    },
  });
}

• Lite SDK Expanded Language Support
  Lite SDK v1.2 adds support for 18+ locales (up from 7 in v1.1), including European and Asian language codes such as de, fr, it, ja, ko, ru, and zh-CN.

​

v1.1.0

• Async SDK Methods
  The initialize(), mountCheckout(), and startCheckout() methods now return Promises. Add await or .then() to each call — synchronous usage will no longer work.
  Migration guide →

const yuno = await Yuno.initialize(PUBLIC_API_KEY);
await yuno.startCheckout(config);

• continuePayment Method
  Introduced continuePayment() for handling complex payment flows. Call it when the API response includes sdk_action_required: true — the SDK then automatically renders 3DS challenges, external wallet steps, or redirects as needed.

const yuno = await Yuno.initialize(PUBLIC_API_KEY);

await yuno.startCheckout(config);

if (paymentResponse.sdk_action_required) {
  const result = await yuno.continuePayment();
}

• Simplified 3DS Integration
  3DS data collection and setup are now bundled into the payment creation step. Remove any standalone 3DS setup service calls — implement continuePayment() and yunoPaymentResult() callbacks instead.
• Boleto Bancário Support
  Boleto Bancário is now available for merchants operating in Brazil, expanding local payment options for customers who prefer offline payment methods.
• Hybrid Cards Default to Credit
  Brazilian hybrid cards are now processed as credit by default, improving authorization rates for Brazil-based merchants.
• Airwallex Security Integration
  Integrated Airwallex as an additional security layer for web payments, enhancing fraud protection without requiring extra configuration.
• Forter Fraud Prevention
  Integrated Forter’s fraud prevention technology. The SDK automatically collects device signals; no separate setup is required.
• Checkout.com 3DS Support
  Added support for Checkout.com as a 3DS provider. The SDK renders the authentication page automatically when the transaction provider is checkout3ds.
• Unlimit 3DS Support
  Introduced 3DS authentication support for Unlimit payments, enhancing fraud prevention for merchants using the Unlimit provider.
• Click-to-Pay Enhancements
  Terms & Conditions and card logos now update dynamically based on the selected card. C2P options are hidden for unsupported cards. A phone number field has been added for C2P registration. Compliance settings for privacy and tnc are forwarded with each card.
• Inline Card Input
  Customers can now enter card details directly beneath the Card option without navigating to a separate screen. Fields persist when switching payment methods, and the flow is fully compatible with installments and the card selector.

• Lite SDK Initial Release
  Launched the Lite Web SDK (v1.1) — a streamlined integration offering essential payment methods, async initialize() support, and core callbacks (yunoPaymentResult, yunoError) with reduced setup complexity.

const yuno = await Yuno.initialize(PUBLIC_API_KEY);

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

​

v1.0.0

• Initial SDK Release
  First stable release of the Yuno Web SDK. Provides four integration variants: Full Checkout SDK, Lite Checkout SDK, Seamless SDK, and Headless SDK — covering a full range of UI customization needs.
• Core Payment Methods
  Out-of-the-box support for credit and debit cards, digital wallets (PayPal, Apple Pay, Google Pay), bank transfers, direct debits, and regional local payment methods across multiple currencies and countries.
• Three Integration Modes
  SDK can be loaded via an HTML <script> tag, dynamic JavaScript, or as an npm module (@yuno-payments/sdk-web), supporting both classic and modern JavaScript framework workflows.
• Seven Language Support
  Initial international support includes Spanish (es), English (en), Portuguese (pt), Filipino (fil), Indonesian (id), Malay (ms), and Thai (th).
• Core SDK Methods
  Provides Yuno.initialize(), startCheckout(), mountCheckout(), and startPayment() as the foundational API surface. All methods are synchronous in v1.0.

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