Widget V3 Changelog
This release introduces new payment methods, including HiPay Bancomat Pay and Lyra Creditcard white label. We've also enhanced the reliability of Apple Pay availability detection, resolved a race condition for ACI payments, and improved the security of merchant-supplied texts in hosted forms.
partner-ui, providing a more consistent and reliable buyer experience.This release brings significant improvements to error visibility, ensuring integrators receive comprehensive reports for uncaught issues. Buyers will benefit from enhanced payment experience with Google Pay and Apple Pay, alongside a more stable UI for payment methods during session refreshes. We've also boosted security by preventing sensitive payment data from appearing in the DOM and refined the card form experience on mobile devices.
/init calls, reducing network traffic and improving performance.A fix improves PayPal payment flow reliability in certain webview environments.
We're excited to announce the availability of Stripe Google Pay, offering your buyers another convenient payment option. This release also includes an upgrade to PayPal SDK v6, bringing enhanced reliability and consistent button styling. Additionally, the widget now offers improved stability during payment initialization failures and new configuration options for tokenized payments.
merchant_specifics.pay_token_no_cvv.NO_LOYALTY_ACCOUNT status during initialization.init failures, preventing excessive network calls and improving stability.Adds Adyen Bizum, Adyen Apple Pay, and Alma Carte Bancaire 10x. Apple Pay and PayPal initialization failures now surface instead of leaving a dead button.
apiPaths passed to a bundle that enforces its own API URLs now log a console warning instead of being silently ignored./init calls.Hosted form validation keys are renamed. Fixes to PayPal and Apple Pay initialization, accordion method switching, and cardholder name masking.
*CannotBeEmptyError to *RequiredError.low impactMigration guide
Only affects integrations that override validation messages. The old keys still resolve but will be removed in a future major.
// Before
const options = { hostedForm: { panCannotBeEmptyError: 'Card number is required.' } };
// After
const options = { hostedForm: { panRequiredError: 'Card number is required.' } };
paymentMethod not provided.plugin_result.logs is absent.TECHNICAL_ERROR from a reused pay-button element.preValidate no longer fails on an unset partnerUI instance under Svelte 5 legacy mode.holderName masking drops the last character, and formDataChanged is logged only once every field is valid; WIDGET_UI_METHOD_UNSELECTED is no longer emitted during an internal payment method suspension.The widget now offers Stripe Apple Pay as a new payment method. We've also addressed critical issues, ensuring Apple Pay and PayPal methods remain active after switching, preventing crashes for Ingenico Google Pay/Apple Pay, and improving Floa initialization.
We've added support for Younited BNPL 2-3-4x installments, giving your buyers more flexible payment options at checkout.
hideHolderName option to hide the holder name field when it is not required. When the backend marks holder name as mandatory for a given payment method, the field is always shown regardless of this option.WIDGET_UI_METHOD_SELECTED and WIDGET_UI_METHOD_UNSELECTED events now fire correctly when the payment sheet opens and closes, fixing X-Pay gaps in analytics.BAD_REQUEST errors during initialization.CustomElementRegistry errors that prevented widget initialization in some environments.SyntaxError that caused crashes.SMART_RETRY API status no longer triggers a JSON parsing error in the widget.This release resolves a critical issue affecting Google Pay integrations with Ingenico/Worldline. Transactions now proceed reliably by correctly handling default gateway and network information, preventing silent tokenization failures.
Google Pay payments processed via Ingenico/Worldline now correctly use the worldlineingenicoogone gateway and appropriate network types (Mastercard/Visa) as fallback when specific payment product data is unavailable, ensuring successful tokenization.
This release introduces new customization options for PayPal buttons, allowing integrators more control over their appearance. We've also addressed several issues across various payment methods, improving currency display for secondary tokens and enhancing the overall stability of the payment flow.
This release updates the underlying UI component library, reflecting the latest brand guidelines and improving visual consistency across the payment experience.
The SDK now reads currency for gift cards, vouchers, and ANCV tokens directly from the payment session, resolving display inconsistencies. Data mapping for illicado, easy2play giftcard, mybeezbox, and ogloba has been improved for accuracy.
setPaymentSession no longer lead to uncaught errors.This release significantly expands payment options by introducing Sogecommerce Apple Pay and Google Pay, along with new Buy Now, Pay Later (BNPL) methods including PayPal BNPL and Younited Installments. We've also enhanced existing payment methods like Alma with improved validation and Oney with better handling for private cards. Various stability and UI fixes ensure a smoother, more reliable payment experience for your buyers.
- Payment methods are now gracefully disabled when the amount is zero, preventing crashes.
- The SDK now correctly handles 725 errors when the payment button is not clicked.
- 3DS authentication is now skipped when no authentication URL is returned, ensuring a smoother buyer experience.
- The SDK now prevents double redirection calls during the payment process.
- The payment manager consistently handles final payment redirections.