Migration
Migrating from v3 to v4
For detailed instructions on how to upgrade your integration from v3.x to v4, see our migration guide.
Highlights:
Callback support removed. Every
create()method and asynchronous instance method now returns aPromiseonly.ES2017 required. The SDK is compiled to ES2017. Internet Explorer and other pre-ES2017 environments are no longer supported. Building the SDK from source now requires Node.js 20 or later. This requirement affects build tooling only, not the browser runtime your integration ships to.
Deprecated components removed. The SDK removes support for Masterpass, Payment Request, and Visa Checkout. The deprecated
paypalcomponent has been removed. Use PayPal Checkout V6 (paypal-checkout-v6).Google Pay defaults to v2. The SDK removes the Google Pay API v1. Integrations that omitted
googlePayVersionare now on v2.Venmo requires
paymentMethodUsage. Single-use integrations must also includetotalAmount. The SDK no longer inspects the URL hash for payment status, and returned usernames no longer include the@prefix.