# Versioning and change log

This log details any breaking and non-breaking API changes we have released for our Checkout Web SDK.

Prerequisite
Make yourself familiar with our [API principles](/products/reference/api-principles) to ensure a resilient integration.

## Versioning log

#### Version 2 (22 January 2024)

PCI and Payments API support
#### Support for enhanced card sessions

- The SDK now returns a card session URL in the form of `https://access.worldpay.com/sessions/...`. Previously, the card session URL looked like this: `https://access.worldpay.com/verifiedTokens/sessions/...`


The format of the new card session URL supports our new upcoming Payments API, whilst also remaining compatible with our Verified Tokens API.

## Change log (non-breaking changes)

#### Release of version 2.5.0 of Web SDK (03 September 2026)

More details
We have released version 2.5.0 of our Checkout Web SDK, which includes the below changes:

* You can now listen to the [`wp:funding-type:change` event hook](/products/checkout/web/event-hooks#wpfunding-typechange), which indicates the funding type associated with the card number entered by your customer. This triggers once your customer enters at least the first 12 digits of their card number.
* The [`wp:card-brands:change` event hook](/products/checkout/web/event-hooks#wpcard-brandschange) has been updated to trigger once your customer enters at least the first 12 digits of their card number. It returns the brands associated with the card number entered.
* [`wp:card:change`](/products/checkout/web/event-hooks#wpcardchange) is deprecated and must not be used. It has been superseded by [`wp:card-brands:change`](/products/checkout/web/event-hooks#wpcard-brandschange) and will be removed in the next major version.
* The following [form tag classes](/products/checkout/web/styles#form-tag) are **deprecated**: `.visa`, `.mastercard`, `.amex`, `.jcb`, `.diners`, `.maestro`, `.discover`.
You **must not use these** as they may be incorrectly set for certain card numbers. Instead, use the [`wp:card-brands:change` event hook](/products/checkout/web/event-hooks#wpcard-brandschange) to detect the card brand associated with the card number entered by your customer.


#### Luhn compliance checks disabling (31 March 2026)

More details
You can create sessions with [non-Luhn compliant cards](/products/access/checkout/web/luhn-compliance#why-disable-luhn-compliance) by setting `allowNonLuhnCompliantCards` to "true".

#### Support for co-branded cards (24 June 2025)

More details
You can now listen to the `wp:card-brands:change` event hook which will return the brands associated with the card number entered by your customer.

This field replaces `wp:card:change` which will be deprecated in the next major version.

2024
#### Shadow DOM support (19 September 2024)

More details
You can now use the Access Checkout Web SDK in a [Shadow DOM](/products/checkout/web/shadow-dom).

#### Session without CVC (25 April 2024)

More details
You can now [omit CVC](/products/checkout/web/card-only#create-a-session-without-cvc) when creating a card session.

2022
#### Caret color customization and numeric keypad (07 November 2022)

More details
We have released a new version of our Web SDK 1.11.0. This version will enable you to customize the caret color in PAN, Expiry date and CVC input fields by setting the [`caret-color`](/products/checkout/web/styles#allowed-css-properties) property in CSS.

On mobile devices, these input fields will now display numeric keypad as the customer enters their card details.

#### React.js integration example (24 February 2022)

More details
We have added an [integration example using a React.js application](/products/checkout/web/integration-react) to our Web SDK documentation.

#### New remove feature (24 February 2022)

More details
We have added a feature allowing you to [remove the SDK](/products/checkout/web/card-and-cvc#removing-the-sdk) from a page.

2021
#### Vue.js integration example (08 December 2021)

More details
We have added an [integration example using a Vue.js application](/products/checkout/web/integration-vue-js) to our Web SDK documentation.

#### PAN formatting (06 September 2021)

More details
[PAN formatting](/products/checkout/web/formatting) allows you to format the card in your checkout form as the customer types.

#### Card brand configuration (15 February 2021)

More details
The [card brand configuration](/products/checkout/web/card-brands) allows you to restrict the cards that you accept on your checkout form.

2020
#### Accessibility feature (10 November 2020)

More details
This feature allows you to customize the [accessibility](/products/checkout/web/accessibility) aspects of your SDK integration.

#### Clear form feature (10 November 2020)

More details
We have added a [`clearForm` feature](/products/checkout/web/card-only#clear-form) allowing you to create sessions for multiple cards without reloading the SDK.

##### CVC session increased lifespan (19 October 2020)

More details
We have increased the lifespan of the CVC session from one minute to 15 minutes.

#### CVC only mode (16 March 2020)

More details
You can now create a `sessions` object for your customer's CVC only. See the full guide [here](/products/checkout/web/card-and-cvc).

#### Card and CVC mode (14 April 2020)

More details
You can now create to separate sessions for your customer's card details and CVC. See the full guide [here](/products/checkout/web/card-and-cvc).