Checking access…

Skip to main content
Version: v2

Widget Versioning

The CCG Widget (Convenient Checkout Gateway Widget) follows its own semantic versioning cadence, independent of the CCG API version. Widget releases are hosted on the CCG CDN and can be loaded via a <script> tag or the NPM bootstrapper package.

The canonical source of all available versions is the Version History page β€” always check there for the latest release.


Available versions​

The following versions are available on the CDN as confirmed in the Version History page. Support policy, patch commitments, and end-of-life terms are owned by the Widget team β€” confirm with your CCG representative before relying on a specific version for production.

Widget versionSeriesNotes
v3.6.0v3Current release β€” confirmed in version-history.html
v3.5.0v3Available
v2.64.0v2Available β€” backwards-compatible flows only
v2.63.0v2Available β€” backwards-compatible flows only
< v2.63.0v2Not listed in version-history.html; availability unconfirmed β€” use v2.63.0 or later
Choosing a version

Pin to a specific version in production to avoid unintended breaking changes. The Version History page lists all available versions and their release notes.


CDN URL format​

https://{env}.healthsafepay.com/wallet/{version}/{filename}
PlaceholderValues
envwalletprod Β· walletstage Β· wallettest Β· walletdev
versionFull semver prefixed with v, for example v3.6.0. See Version History for all available versions. The CCG Widget NPM bootstrapper loads the widget using the major-version alias (e.g. v3) as the CDN path; this alias resolves to the latest certified release in that series. Pin to a full semver for production stability.
filenameccg-widget.js (unminified) Β· ccg-widget.min.js (recommended for production)

Production examples:

<!-- Pinned to a specific version (recommended for production stability) -->
<script src="https://walletprod.healthsafepay.com/wallet/v3.6.0/ccg-widget.min.js"></script>

<!-- Major-version alias β€” resolves to the latest v3 certified release -->
<script src="https://walletprod.healthsafepay.com/wallet/v3/ccg-widget.min.js"></script>

Non-production example:

<script src="https://walletstage.healthsafepay.com/wallet/v3/ccg-widget.min.js"></script>

Widget v3 vs Widget v2​

CapabilityWidget v3Widget v2
Required for V1 to V2 migrationYesNo
Split tender (pay with multiple payment methods)YesNo
HSA-aware walletYesNo
Standard single-payment flowsYesYes
Backwards-compatible V1-origin flowsYesYes
NPM bootstrapper (CCGWidgetInitializer)YesNo
Legacy NPM (OptumCCGWidgetInitializer)NoYes

Use Widget v3 for all new integrations and for any V1 to V2 migration. Widget v3 is required to unlock split tender and HSA-aware wallet capabilities.

Use Widget v2 only if you have an existing integration that relies on the legacy NPM package (OptumCCGWidgetInitializer) and you have not yet migrated. Confirm patch and maintenance terms for v2 with your CCG representative.


NPM package versions​

The widget is also available as an NPM package for teams who prefer a compiled dependency over a <script> tag.

PackageSeriesInstall command
@uhg-ccg-proj/convenient-checkout-ui (v3 bootstrapper)v3npm install @uhg-ccg-proj/convenient-checkout-ui --save
@uhg-ccg-proj/convenient-checkout-ui@2 (legacy)v2npm install @uhg-ccg-proj/convenient-checkout-ui@2 --save

The v3 NPM package is a lightweight bootstrapper (~120 KB) that loads the full widget bundle from the CDN at runtime. This means your app bundle stays small, and widget updates (bug fixes, security patches) are delivered automatically without requiring a package version update or redeployment.

See the Embedded Experience page for full integration instructions, including the v3 bootstrapper API reference.


Known issues​

See Known Issues for a list of resolved and open widget issues by version.