Web SDK

​

🔧 Fixes

• Apple Pay deferred payment request: freeCancellationDate and freeCancellationTimeZone are optional, but they must either both be provided or both be omitted.

​

🚀 New features

• Apple Pay iframe support: Added merchantDomain option for Apple Pay when rendered within an iframe. This optional string parameter allows setting the top window domain for proper Apple Pay functionality in iframe contexts. See our documentation for more info.

​

🔧 Fixes

• Fixed Google Pay line item amount formatting
• Fixed cardholder name required and visible toggle functionality

​

🔧 Fixes

• Fix minor compatibility issue in certain legacy browsers.

​

🚀 New features

​

🔧 Fixes

• Fix issue where vaulted Stripe ACH tokens could not be selected to make payments due to an error.

​

✨ Improvements

• Updated Payment types to include missing payment methods:
  • DLOCAL_PIX
  • ALMA
  • PAY_NL_RIVERTY

​

🔧 Fixes

• Google Pay - Minor bug fix in some edge cases where it was impossible to disable button through headless SDK.

​

🔧 Fixes

• Apple Pay - fixed a bug on headless that resulted in Checkout staying in loading state after cancelling Apple Pay payment sheet too quickly.
• Improves accessibility of hidden inputs

​

✨ Improvements

• Improved support for legacy mobile Safari versions by adjusting bundler settings.
• Resolved compatibility issues affecting early iOS 15 and iOS 16 releases.

​

✨ Improvements

​

🚀 New feature

​

🚀 New feature

​

🔧 Fixes

​

🔧 Fixes

• Fixed an issue where the payment method logo position, relative to the text, was sometimes ignored

​

✨ Improvements

• The SDK will now default to using Api version 2.4 when initialised. It is possible to use the previous defaults by setting legacy via options.apiVersion. For more information see our SDK reference, Api Reference and Migration Guides.

​

🔧 Fixes

• Surcharge information will not be displayed next to the card form when no surcharge is applied; the card form will not be automatically hidden when the surcharge is applied - use SDK Options to hide the card form if needed.

​

🔧 Fixes

• Fixed a bug in the Klarna session update flow, which may cause validation failures when the Klarna session is triggered and potentially prevent the session from updating correctly.

​

🔧 Fixes

• Fixed Google Pay OR_BIBED_15 error where the payment popup failed to open due to a network request. The popup is now triggered immediately upon clicking the Google Pay button, ensuring compliance with browser restrictions on user-initiated popups. As a result, any updates to the client session must now be refreshed manually in the SDK by calling refreshClientSession.

• Removed support for iDeal-V1 and the associated bank selector UI from the SDK. With iDeal-V2, users are now redirected to their own bank selector interface, making this functionality redundant. All existing integrations have been automatically migrated to iDeal-V2, requiring no further action from merchants.

​

🔧 Fixes

• Addressed an error (undefined is not an object) occurring with Apple Pay transactions.

​

🔧 Fixes

• Resolved an issue with the Klarna vaulting payment flow. Previously, the Klarna vaulting process was not operational due to missing properties. This fix ensures proper communication between the SDK, Primer and Klarna, enabling successful vaulting across all Klarna-supported payments.

​

🔧 Fixes

• Fixed missing TypeScript types for StripeACH options on showUniversalCheckout options. This resolves issues where TypeScript users encountered type errors when configuring StripeACH payments.

​

🔧 Fixes

• Fix double surcharge and top-level amount calculation for Google Pay

​

✨ Improvements

• With this release, we introduce a new property, apiVersion:
  • This property allows you to modify which API the SDK will use internally. By default, the previous API state is selected, ensuring backward compatibility. The new APIs are used by opt-in.
  • To use our new API 2.4 functionalities, set the apiVersion to “2.4”.
  • This update enables you to migrate to API 2.4 gradually without disrupting your existing integrations.

• SDK Reference
• API Reference
• Migration Guides
• Added support for iDEAL v2 via Adyen on Headless

​

🔧 Fixes

• Cardholder Name now supports non-Latin characters correctly.

​

✨ Improvements

• Removed two legacy SDK flows:
• Single Payment Flow: A simplified one-payment view that hasn’t been used in production for over a year. Its removal simplifies the codebase, improves maintainability, and strengthens the overall logic.
• Express Checkout: A legacy, unstable flow introduced in 2022, never officially released but present in TypeScript declarations and some code files. As we are not pursuing this approach further, all related code has been removed, simplifying the PayPal integration and client session logic.
• Amount checks on Apple Pay and Google Pay—We removed a client-side check for these payment methods, as it was no longer needed. Passing value 0 enables some specific vaulting flows.

​

✨ Improvements

• This release introduced several updates to the dependencies used by the web SDK, primarily related to TypeScript type generation, linting, and build pipelines.
• Notable customer-facing dependency updates include:
  • card-validator and credit-card-type, which are responsible for validating and recognizing cards client-side. Keeping these up to date ensures your clients won’t encounter issues with the card form.
  • @stripe/stripe-js, used to render the Stripe ACH payment form and its components.
• We have also improved the overall code quality and ensured more reliable execution.

​

🚀 New feature

• We have added support for Vaulting for ACH via Stripe. ACH lets you accept payments from customers with a US bank account.
• Read about the prerequisites here

​

🔧 Fixes

​

🔧 Fixes

• Fixed the bug introduced in 2.46.0, which broke the localized error messages and displayed the error code in square brackets instead.

​

🔧 Fixes

• Item description
• Fee type

​

🔧 Fixes

• Bug fixes and improvements

​

🔧 Fixes

​

✨ Improvements

​

🔧 Fixes

• Klarna locale now defaults to en_US if the provided locale is not supported.

​

2.46.2

​

🔧 Fixes

​

✨ Improvements

• We’re able to address issues affecting your clients proactively.
• Faster resolution of support escalation tickets, thanks to more detailed session analysis.
• Continued improvements to the stability and performance of our SDK.

​

🔧 Fixes

• Fix for PayPal - remove the condition check in SDK that would break PayPal for merchants that are passing top level amount property in the create client session request

​

🔧 Fixes

• Fix the translation of “Cardholder name” in Bulgarian

​

✨ Improvements

• Bug fixes and improvements

​

🔧 Fixes

• An issue that prevented the SDK from being re-initialized when clientSessionCachingEnabled is set to true has been fixed.

​

✨ Improvements

• CDN assets improvements

​

🔧 Fixes

• Fixed typescript definitions generation

​

✨ Improvements

​

✨ Improvements

​

🚀 New feature

• We have added support for ACH via Stripe. ACH lets you accept payments from customers with a US bank account.
• ACH Direct Debit is a reusable, delayed notification payment method. It can take up to 4 business days to receive acknowledgment of success or failure.
• This release includes one-off payments and cancellation and refund actions. We aim to add support for recurring payments in the future.
• With just a few clicks through Primer, you can easily integrate ACH via Stripe into your payment stack. Visit the integrations section of the dashboard to learn more, or consult the direct integration guide.

​

🔧 Fixes

• Fixed a bug on Firefox where the user needed to double-tab to focus on input fields.
• Added missing id properties to the Payment Method buttons.
• Fixed an issue that prevented importing the Primer package on the server

​

✨ Improvements

​

✨ Improvements

• Bug fixes and improvements.

​

✨ Improvements

• A default font size for APM button text was added.

​

✨ Improvements

• Performance and monitoring enhancements.

​

✨ Improvements

• Enhanced reliability of configuration requests in poor connectivity conditions.
• Improved initialization script loading.
• Performance and monitoring enhancements.

​

✨ Improvements

• Performance and monitoring enhancements.

​

🔧 Fixes

• Fixed Headless PayPal to work correctly when paymentFlow is set to PREFER_VAULT.

​

🔧 Fixes

• Fixed an issue that prevented inputting card numbers with more than 16 digits.

​

🔧 Fixes

• Fixed an issue where client session updates did not set the amount correctly on Headless Google Pay.

​

🔧 Fixes

• We have fixed an issue in AssetsManager.getPaymentMethod. Previously, the paymentMethodName parameter would return the recommended button text for a payment method, which could be null for many payment methods. We have deprecated this parameter and added two new ones:

​

💳 New APM

​

iDEAL via Adyen

• load a list of all supported banks
• submit user’s selection

​

🚀 New Feature

• Drop-In: Card Security Code (CSC/CVV) recapture
  • Vaulted cards can now optionally capture the customer’s CVV, which sometimes can increase approval rate
  • To enable this feature, create a client-session with the option captureVaultedCardCvv
  • CVV cannot be vaulted because of PCI DSS

​

🔧 Fixes

• Suppress noisy logs for sessionStorage.setItem and navigator.sendBeacon when the browser does not support them, or they are disallowed by the user, or when they fail for any other reason
• Prevents iframes from going opaque when the browser is set with a different color-scheme

​

🔧 Fixes

• Upgraded PayPal order creation to the latest server-driven PayPal SDK
• We were using an old way of creating a PayPal order (via actions.order.create from PayPal’s JS SDK) that PayPal is deprecating in June 2024. This version upgrades a PayPal payment method order creation using Orders v2 APIs and PayPal JavaScript SDK
• We introduced a change in the metadata field that is passed when creating a client session. Previously orderId in the client session would be passed to PayPal as the custom\_id. Now you have to pass paypal_custom_id  in the metadata.

​

🔧 Fixes

• Headless now correctly triggers onPaymentMethodAction events
• Now shows the loading spinner when a payment is being processed and the card payment method is not available

​

🔧 Fixes

• 3DS popup buttons not being clickable
• Headless hosted inputs default height

​

🔧 Fixes

• Checkout options stylesheets
• Rename icon className to avoid CSS conflicts
• Change the default CVV input size to 4 digits
• Use redirect instead of popup when in an in-app browser
• Hide the loading spinner when there are no payment methods available
• Prevent PayPal from being stuck in infinite loading

​

🔧 Fixes

• Resolved an issue that caused low authorization rate with Apple Pay for certain processors such as Cybersource when the user’s billing address was missing either the first name or last name on their Apple Pay wallet. If Apple Pay is configured to capture the billing address, users will now be prompted with an error message within Apple Pay’s sheet indicating that they need to fill out the missing first name or last name in their Apple Pay wallet in order to proceed with the payment.
• Various internal improvements to enhance overall system stability and performance.

​

🔧 Fixes

• Fixed a regression bug introduced in v2.37.0 that showed an error “This merchant is having trouble accepting your payment right now. Try using a different payment method. [OR_BIBED_06] OR_BIBED_06” when the user selected Google Pay, preventing them from paying.
• You should now be able to propose Google Pay seamlessly as before.

​

🚀 New Feature

• Support for Klarna Headless
  • Our Klarna integration is now available on Headless Checkout on Web. Flows supported:
    • Pay now
    • Pay later: Pay in 30 days
    • Pay over time: Pay in 3-4 installments. First payment right away then the rest in installments (no interest)
    • Fair financing: Installment plans of 6, 12, 24, and 36 months with flexible payments (with interest)
  • The docs are available here and the Klarna Payment Manager reference is here.
• Support for Klarna EMD
  • Klarna may request extra merchant data (EMD) based on the merchant segment or consumer services. This additional information helps Klarna enhance risk assessment and improve conversion rates.
  • You can now dynamically pass any relevant EMD package via the Client Session as described here. Available schemas are documented here

​

🔧 Fixes

• Fixed an issue with Klarna that caused the Klarna view to expand and then collapse when switching between payment categories.
• Fixed an inconsistency in the input’s metadata for Headless Vault Manager CVV recapture. Developers can now rely on the “input.metadata.valid” property to be their source of truth when checking if the validations have passed.

​

🚀 New Feature

• Added support for iDEAL via Adyen on Headless

​

🔧 Fixes

• Provide translated error message for CVV required error on Headless Checkout Vault Manager in cvvInput.metadata.error
• Note that cvvRequired errorCode is still exposed in cvvInput.metadata.errorCode property

​

🔧 Fixes

• Build artefact (webpack) that prevented npm package to run correctly in the browser

​

🚀 New Feature

• Support for co-badged cards on Headless Checkout (documentation will come soon)

​

🚀 New Feature

• Added Drop-in payment method: iDEAL via Stripe

​

🔧 Fixes

• Drop-in Checkout’s submitButton.amountVisible setting now correctly displays amount for card payments in the “Pay” button

​

🔧 Fixes

• Validation for card information when using browsers’ built-in autofill is now more reliable, especially on Safari

​

✨ Improvements

• Optimized bundling for the core package and all payment methods
  • This should result in the SDK loading up to 30% faster

​

🔧 Fixes

• Fixed an issue with Klarna items using “description” rather than “name”

​

🚀 New Feature

• Add support for initializing PayPal with a “capture” intent

​

🔧 Fixes

• Card autofill when using browsers’ built-in autofill, especially Safari

​

✨ Improvements

• Improve usage analytics

​

🔧 Fixes

• Fix Klarna’s shipping fees and calculation for tax rates
• Fix server side rendering

​

🔧 Fixes

• Fix the Drop-In and Headless Checkout not honouring the allowedCardNetworks configuration option.

​

✨ Improvements

• Improve performance of analytics on the SDK, now calls will be made when the user device is idle and won’t slow down the payment flow

​

🔧 Fixes

• Prevent unwanted retries of calls to Primer API

​

✨ Improvements

• Add addEventListener alias for the addListener method of CVVInput

​

🔧 Fixes

• Fix CVVInput events not being triggered

​

🔧 Fixes

• Update Klarna button to better adhere with their guidelines
• Fix an issue with Drop-in that could happen when both Multibanco and Blik were active in the same session (which is extremely unlikely)

​

🔧 Fixes

• Activate 3DS when cards are not configured in checkout builder. This ensures that 3DS can be triggered even if only Google Pay or Apple Pay are presented.

​

🔧 Fixes

• Fix 3DS not appearing properly in Headless Checkout
• Fix an issue that prevented users to pay with a vaulted PayPal account if a card is also present in the vault

​

🔧 Fixes

• Fix an issue that caused onResumeSuccess to be called with an undefined resume token when forceRedirect is set to true
• Improve the logic for setting the size of the 3DS window
• Fix an issue raised in 2.32.0: the CVV input now forwards a cvvRequired error if the user has not yet interacted with it

​

🚀 New Feature

​

Headless Vault Manager

• fetch a list of vaulted payment methods
• delete a vaulted payment method
• perform a payment using a vaulted payment method
• create an input to collect the CVV for a vaulted payment method

​

🐛 Known issues

• The CVV input does not forward a cvvRequired error if the user has not interacted with it.
• This has been fixed in 2.32.2

​

✨ Improvements

• Allow PayPal button to take the full width available

​

🔧 Fixes

• Fix a regression introduced in 2.28.1 that prevented onCheckoutFail from returning the payment object when available

​

🚀 New Feature

​

Validate cardholder name

​

✨ Improvements

• Change the “CVV” label to “Security code” in Japanese.

​

🔧 Fixes

• Fix an issue that caused a crash when closing Adyen Klarna’s redirect popup window. The issue was introduced in 2.30.0.
• Fix onPaymentMethodAction on Web not being triggered with Klarna.

​

🚀 New Feature

​

Popup windows fallback to redirect

• This is a fallback mechanism, when popup windows are supported they will continue to open as expected.
• forceRedirect is still supported.

​

✨ Improvements

• Update english translations

​

🔧 Fixes

• Fix a bug where the submit button was disabled when moving to another screen and coming back to the checkout home, while any vaulted payment method was present.
• Enable the Apple pay button to work within a form tag

​

🔧 Fixes

• Fix an issue that caused onCheckoutFail to not be called when the payment ends up with a PENDING status and no required action. This could happen in the case of Atome when the user clicks “Back to merchant”
• Fix a bug that caused the flag form.inputLabelsVisible to also hide surcharge labels
• Improve surcharging support for PayPal when paypal.paymentFlow is set to PREFER_VAULT

​

✨ Improvements

• Improve internal visibility

​

🔧 Fixes

• Fix a race condition on Drop-in Checkout that caused card input fields to not appear
• Fix an issue that broke server-side rendering (crypto not defined or navigation not defined)
• Fix an issue causing screens to disappear after calling refreshClientSession
• Improve API error handling

​

🔧 Fixes

• Fix a race condition on Headless that caused card input fields to not appear
• Fix an issue that prevented surcharging to be displayed for amex and diners club
• Fix the typescript definitions of the main SDK functions

​

🔧 Fixes

• Fix an issue that prevented the UI of card surcharge to be updated after refreshClientSession() is called
• Add warning messages when Adyen via Klarna does not receive any payment method to display

​

🐛 Known issues

• If a surcharge for a card network is set, then removed after calling refreshClientSession(): the UI can fail to display the card fields
• The checkout behaves strangely when surcharge is setup then removed or the other way around

​

✨ Improvements

​

Google Pay now capture billing address information! 🥳

    Primer.showUniversalCheckout(clientToken, {
    googlePay: {
    captureBillingAddress: true // defaults to false - not required
    }
    })

​

🔧 Fixes

• Improve error handling when initializing the SDK
• Fix a regression from 2.25.1 issue that raised a malformed client token bug when the user selects a redirect-based payment method

​

✨ Improvements

​

The SDK now speaks Chinese, Thai and Malay 🌐

• Mainland Chinese (simplified characters) zh-CN
• Thai th
• Malay ms

• Chinese from Hong-Kong zh-HK
• Chinese from Taiwan zh-TW

Chinese card details

​

✨ Improvements

const checkout = await Primer.showUniversalCheckout(clientToken, options);
// After you patched the client session
await checkout.refreshClientSession();

​

🔧 Fixes

• Headless Checkout’s onAvailablePaymentMethodsLoad is now working properly
• Improved the support for specific versions of Webpack (window is undefined error)
• Improved the error handling of the client token

​

✨ Improvements

​

Load time improved by ~20% 🏃‍♂️

​

Known issues

​

✨ Improvements

​

Add Processor 3DS to Headless Checkout

​

✨ Improvements

​

✨ Improvements to Google Pay!

• Supported values are fill and static
• ⚠️ This mechanism replaces the buttonType values short and long.

• buy (default)
• book
• checkout
• donate
• order
• pay
• plain
• subscribe

Google Pay Buttons

Primer.showUniversalCheckout(clientToken, {
/\* Other options \*/
googlePay: {
buttonSizeMode: 'fill',
buttonType: 'subscribe'
}
});

​

🔧 Fixes

• Fixed an issue with the sub-units of the currencies CRC, COP and HUF

​

✨ Improvements

​

iDeal via Worldpay! 🥳

Select your bank

​

✨ Improvements

​

Better support for manager types

// Before
headless.configure({
// Other options
onAvailablePaymentMethodsLoad(paymentMethods) {
// paymentMethods is a list of strings representing the unique id of the payment method
}
})
// Now
headless.configure({
// Other options
onAvailablePaymentMethodsLoad(paymentMethods) {
// paymentMethods is a list of objects containing
// - `type`: the unique id of the payment method
// - `managerType`: the type of payment method manager. Can be `CARD`, `NATIVE`, or `REDIRECT`
}
})

​

Get access to the icons and names of payment methods on headless

const assetsManager = headless.getAssetsManager()
const { iconUrl, paymentMethodName, backgroundColor } = await assetsManager.getPaymentMethodAsset('ADYEN\_IDEAL') // ADYEN\_IDEAL comes from `paymentMethod.type`

​

Redirect payment methods are on Headless Checkout 🚀

• opens a popup to present a loading indicator, then the payment method web page
• shows an overlay on top of your page that prompts the user to focus on the popup

​

🔨 Fixed

• Fixed a bug causing Apple Pay to not properly handle currencies without minor units

​

🔨 Fixed

• Address bug which caused an internal API validation error when receiving a billing address back from Apple Pay without the state field.

​

✨ Improvements

​

Added onPaymentCreationStart callback

• You will now be able to rely on the onPaymentCreationStart callback to get notified before the checkout attempts to perform the following actions:
• Tokenize the selected payment method

const checkout = await Primer.showUniversalCheckout(clientToken, {
container: '#container',
onPaymentCreationStart() {
// will be called before tokenization and payment creation
// will be followed by calls of either onCheckoutComplete
// or onCheckoutFail
},
onCheckoutComplete({ payment }) {
console.log('onCheckoutComplete', payment);
},
onCheckoutFail(error, { payment }, handler) {
console.error('onCheckoutFail', error, payment);
handler?.showErrorMessage(');
},
});

​

🔨 Fixed

• Addressed bug which caused iframe events to not be fired with headless checkout implementation.

​

✨ Improvements

​

Apple Pay, Google Pay and PayPal are landing on Headless Checkout 🚀

Payment methods

​

🔨 Fixed

​

🔨 Fixed

• Address bug which caused the cardholder name to not be tokenized along with the other card information.
• Addressed bug which caused the onPaymentMethodAction callback to not be called.

​

✨ Improvements

​

Klarna via Adyen! 🥳

Klarna

​

🔨 Fixed

• Fix bug where the card number input could not detect the AMEX card network type.
• Addressed edge case where a payment is created with an empty card form, resulting in an error. In this case, onCheckoutFail will now be called.

​

🔨 Fixed

• Fix an issue with a 404 happening when loading the SDK in server-driven environments

​

✨ Improvements

​

[BETA] Introducing Headless Checkout for complete customization! 🚀

const headless = await Primer.createHeadless(clientToken);
await headless.configure({
onAvailablePaymentMethodsLoad(paymentMethodTypes) {
// Handle payment methods
},
onCheckoutComplete({ payment }) {
// Show success screen
},
onCheckoutFail(error, { payment }, handler) {
// Show checkout fail
return handler.showErrorMessage();
}
});

​

✨ Improvements

​

Bancontact Debit via Adyen 🏦

Bancontact

​

✨ Improvements

​

Gift Card via PayNL KaartDirect! 🎁

​

🔨 Fixed

• Fix submit button being disabled when no APMs are loaded

​

✨ Improvements

​

Disable checkout autofocus! 👀

​

EPS via Adyen 🏦

​

🔨 Fixed

​

The start of Server Driven Payment Methods! 👏

​

🔧 Fixes

• Update Clearpay naming to be Afterpay in the overlay dialog and loading page
• Enable our instance of PayPal to work if another instance of PayPal is running within the same window. The PayPal button now renders even if the merchant application is running a separate instance.

​

✨ Improvements

​

Apple Pay now capture billing address information! 🥳

Primer.showUniversalCheckout(clientToken, {
applePay: {
captureBillingAddress?: true // defaults to false - not required
}
})

​

setClientToken → refreshClientToken 😎

const checkout = await Primer.showUniversalCheckout(clientToken, {
// provide your settings
})
// This will result in the checkout
// being updated after patching a client session
checkout.refreshClientToken();

​

🔨 Fixed

• The checkout now no longer fails to apply surcharging to American Express cards

​

✨ Improvements

​

Better Klarna support! 🤯

• We’ve expanded the locale, country code and currency support for Klarna. You’ll now be able to serve your customers better with Klarna across multiple territories.
• Klarna now works when passing tax in the client session. Feel free to add your tax amounts to each line items and Klarna will be able to interpret it as such.
• Klarna now also supports passing a discount amount. Passing a discount amount in the client session will be interpreted correctly by Klarna.

​

🔨 Fixed

• Fixed bug which caused SDK to crash in Safari browsers. This bug has been persisting since v2.5.0 of the Web SDK

​

✨ Improvements

​

🔨 Fixed

• Adyen now receives the required information for performing 3DS

​

✨ Improvements

​

Bancontact - Payconiq via Adyen! 🤯

​

Omise from the far east 🌅

​

✨ Improvements

​

Multibanco via Adyen has arrived! 🎉

​

PacyPay payment methods incoming! 🎉

AliPay+ & WeChat Pay

​

We’ve added support for Afterpay! 🎉

​

Increased control over payment method actions 🔍

const options = {
/\* Other checkout options ... \*/
onPaymentMethodAction(action, { paymentMethodType }) {
// Notifies you when a specific payment method has been selected or unselected
// action will either be 'PAYMENT\_METHOD\_SELECTED' or 'PAYMENT\_METHOD\_UNSELECTED'
},
};

​

✨ Improvements

​

MB all the WAY 💸

​

✨ Improvements

​

Paytrail and Payshop via Adyen is now supported 💰

Paytrail & Payshop

​

Improved error handling 🔴

​

Bug fixes 🐛

• Autofocus will now be applied to the first field in the card form and won’t automatically jump to the cardholder name input.

​

✨ Improvements

​

Amount on submit button 💰

Submit Button

const checkout = await Primer.showUniversalCheckout(clientToken, {
container: '#container',
submitButton: {
amountVisible: true,
}
}

​

Trigger card form submission on enter press ↩️

Submit on Enter

​

iDEAL via PayNL now uses a dedicated bank list 🏦

Select a bank

​

Klarna now supports passing a product type 🤝

{
// other client session options
"order": {
"countryCode": "SE",
"lineItems": [
{
"amount": 500,
"description": "Voucher",
"quantity": 1,
"itemId": "ABC123",
"productType": "DIGITAL" // digital product
},
{
"amount": 1500,
"description": "Blue Shoes",
"quantity": 2,
"itemId": "XYZ123",
"productType": "PHYSICAL" // physical product
}
]
},
}

​

🔨 Fixed

• The submit button is no longer enabled when the PayPal dialog is closed quickly, leaving no payment method in a selected state
• Expanded locale and country code support for Klarna. The Klarna button should now render for the Irish 🇮🇪 🍀
• All inputs within the checkout now display custom focus and hover styles correctly
• Addressed issue where some payment methods failed when using currencies without minor units

​

✨ Improvements

​

Added support for four new payment methods 🎉

• GrabPay
• Poli
• Gcash
• PromptPay
• Fast

​

New locales 💬

• Czech cs
• Estonian et
• Croatian hr
• Japanese ja
• Lithuanian lt
• Portuguese - Brazil pt-BR
• Vietnamese vi

​

🔨 Fixed

• Fix position of saved payment method dropdown on mobile
• Klarna now allows updating the amount while the SDK is rendered

​

🔨 Fixed

• Fixed a misalignment issue occurring in the vault when a Right-to-Left language is used
• Improved support for currencies: non-decimal currencies such as the Japanese Yen and Vietnamese Dong are now supported 🎉

​

✨ Improvements

​

Right to left language support ↪️ ↩️

Submit

​

New locales 💬

​

🔨 Fixed

• Fixed a TypeScript bug that cause showUniversalCheckout to return an instance of VaultManager. showUniversalCheckout now returns type UniversalCheckout.

​

✨ Improvements

​

New locales 💬

• Bulgarian bg
• Hungarian hu
• Romanian ro
• Russian ru
• Slovak sk

​

✨ Improvements

​

[BETA] Pay in installments with 2c2p ! 🎉

​

Updated buttons for Coinbase and OpenNode! 💅

​

Improved support for PayPal! 🎉

• If lineItems is provided in the client session, the item breakdown will be passed to the PayPal
• If orderId is provided in the client session, PayPal’s custom\_id will be passed to PayPal

​

🔨 Fixed

• Fixed a bug that prevented formSpacings from being applied to the friendly card name
• Fixed an error raised in the console in the Vault Manager when the user clicks on a saved payment method

​

✨ Improvements

​

🚀 Get started in one line of code!

const Primer = await loadPrimer(); // If the package is loaded from npm
const primer = new Primer({ credentials: { clientToken }});
const checkout = await primer.checkout(options);

// To initialize Universal Checkout
const universalCheckout = await Primer.showUniversalCheckout(clientToken, options);
// To initialize Vault Manager
const vaultManager = await Primer.showVaultManager(clientToken, options);

​

✨ Payments created automatically

primer.checkout({
onTokenizeSuccess(paymentMethodTokenData) {
// Implement some verbose logic 🤢
},
onResumeSuccess(resumeTokenData) {
// Do it all again 😵
}
})

​

💳 Dummy Payment Methods

• PayPal via Primer
• iDeal via Primer
• Klarna via Primer
• Cards via Primer

​

🔨 Deprecation