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 version | Series | Notes |
|---|---|---|
| v3.6.0 | v3 | Current release β confirmed in version-history.html |
| v3.5.0 | v3 | Available |
| v2.64.0 | v2 | Available β backwards-compatible flows only |
| v2.63.0 | v2 | Available β backwards-compatible flows only |
< v2.63.0 | v2 | Not listed in version-history.html; availability unconfirmed β use v2.63.0 or later |
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}
| Placeholder | Values |
|---|---|
env | walletprod Β· walletstage Β· wallettest Β· walletdev |
version | Full 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. |
filename | ccg-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β
| Capability | Widget v3 | Widget v2 |
|---|---|---|
| Required for V1 to V2 migration | Yes | No |
| Split tender (pay with multiple payment methods) | Yes | No |
| HSA-aware wallet | Yes | No |
| Standard single-payment flows | Yes | Yes |
| Backwards-compatible V1-origin flows | Yes | Yes |
NPM bootstrapper (CCGWidgetInitializer) | Yes | No |
Legacy NPM (OptumCCGWidgetInitializer) | No | Yes |
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.
| Package | Series | Install command |
|---|---|---|
@uhg-ccg-proj/convenient-checkout-ui (v3 bootstrapper) | v3 | npm install @uhg-ccg-proj/convenient-checkout-ui --save |
@uhg-ccg-proj/convenient-checkout-ui@2 (legacy) | v2 | npm 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.