Use this guide to compare implementation differences if you are:
- Migrating from Web Components version 2.5.0 and earlier to Web Components version 3.0.0 or later.
- Switching your integration from Web Components version 2.5.0 and earlier to Web Drop-in.
Drop-in requires v49 of the /paymentMethods, /payments, and /payments/details endpoints. If you want to change your integration from Web Components to Web Drop-in, you need to update your endpoint version to v49.
If you are migrating from Web Components version 2.5.0 and earlier to Web Components version 3.0.0, we strongly recommend that you also update your endpoint version to v49.
New configuration property
We introduced the new
environment property in version 3.0.0. This replaces the
loadingContext config property used in versions 2.5.0 and earlier. Instead of specifying the domain, you only need to pass either test or live to set the environment.
Change in state.data object
state.data object returns the shopper's payment details information that you need to pass to your
Starting from version 3.0.0, the
state.data object returns the entire
paymentMethod object that you will need to pass to the
/payments request. In previous versions, the
state.data only includes properties that you pass in the
paymentMethod object of your
Change in isValid method
isValid method in version 3.0.0 is now a getter. In previous versions, the
isValid is a function.