Widget V3 Changelog
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.