SuiteCommerce 2022.2: 3D Secure 2.0 in Payments, GA4 Support, and Configuration Changes
SuiteCommerce 2022.2 adds 3D Secure 2.0 to the Make a Payment and Quote Purchase flows, introduces Google Analytics 4 configuration properties, relocates the Invoice Terms and Conditions config property, and continues to require Node.js 12.21.0 for developer tooling.
What changed
3D Secure 2.0 in Make a Payment and Quote Purchase flows
3D Secure 2.0 (3DS2) authentication is now available in the Make a Payment and Quote Purchase flows across SuiteCommerce, SuiteCommerce MyAccount, and SuiteCommerce Advanced. If your payment gateway supports 3DS2, these flows will now invoke the additional authentication challenge when required by the card issuer.
Google Analytics 4 (GA4) support
Universal Analytics is being sunset by Google. This release introduces first-class GA4 support via three new configuration properties on the SuiteCommerce Configuration record:
tracking.googleAnalyticsFour.propertyID— Your GA4 Measurement ID (e.g.,G-XXXXXXXXXX). Located under Integrations > Google Analytics 4.tracking.googleAnalyticsFour.domainName— Domain for the GA4 tracking cookie. Same location.tracking.googleAnalyticsFour.domainNameSecure— Secure domain for the GA4 tracking cookie. Same location.
Invoice Terms and Conditions config property relocated
The property checkoutApp.invoiceTermsAndConditions has been moved from the Checkout tab to a new Invoice subtab under the Advanced tab on the SuiteCommerce Configuration record. This change makes the property accessible to SuiteCommerce MyAccount deployments, not just full SuiteCommerce/SCA. If you have automation or documentation referencing the old tab location, update accordingly.
Missing translations added
Several hardcoded English strings now have proper translation entries, affecting:
- Product Detail Page: “No Reviews yet”
- Add-to-cart confirmation modal: “Quantity”
- Product review submission: “Back to [product name]”
- Make a Payment wizard: “SELECT INVOICES TO PAY” and the wizard breadcrumb steps
- Account Balance: “Deposits:”, “Other Credits:”, “Term:”, “Currency:”
If you maintain custom translation overrides in these areas, verify your overrides still apply after upgrading.
Node.js requirement unchanged
Developer tools (Theme, Extension, and core SCA tooling) still require Node.js 12.21.0. Note that Node.js 12 reached upstream EOL in April 2022. Plan accordingly if your CI/CD or local environments have already moved to newer versions—you will need to use a version manager like nvm to pin to 12.21.0 for SuiteCommerce builds.
Third-party library additions
The dotenv library (version 16.0.1) has been added to the SuiteCommerce stack. No other library versions were updated.
Extension management bug fixes
- Fixed an error when downloading extension files via
gulp extension:fetchorgulp extension:deploy. - Fixed a CORS-related error that appeared in Chrome and Edge when running the local development server for SuiteCommerce Extension Management and SCA developer tools.
What to do
- Enable 3DS2 for payments: If you use a 3DS2-capable payment gateway, confirm it is configured in your NetSuite account. The Make a Payment and Quote Purchase flows will automatically invoke 3DS2 challenges. Test the full payment flow in a sandbox before going live.
- Migrate to GA4: Navigate to the SuiteCommerce Configuration record > Integrations tab > Google Analytics 4 subtab. Enter your GA4 property ID, domain, and secure domain. If you previously used Universal Analytics, run both in parallel until you are satisfied with GA4 data, then disable UA.
- Verify Invoice Terms config: If you reference
checkoutApp.invoiceTermsAndConditionsin scripts or documentation, note its new location under Advanced > Invoice. The property ID itself has not changed. - Check translation overrides: If you maintain custom translations for the strings listed above, verify they still render correctly after upgrading to 2022.2.
- Pin Node.js 12.21.0: Confirm your development and build environments use Node.js 12.21.0. Consider using
nvm use 12.21.0or an.nvmrcfile in your SuiteCommerce project root. - Update gulp tooling: If you previously hit CORS errors or download failures with
gulp extension:fetch/gulp extension:deploy, upgrade to the 2022.2 developer tools to pick up the fixes.
Source: Oracle NetSuite Release Notes