SuiteCommerce 2022.1.x Minor Releases: Auth Header Patch, External Checkout Fix, and Bug Fixes

What changed

Oracle shipped four minor releases under the 2022.1 branch targeting SuiteCommerce (SC), SuiteCommerce MyAccount (SCMA), and SuiteCommerce Advanced (SCA). The fixes are cumulative — each later release includes everything from the earlier ones.

2022.1.4

• Fixed a layout-inheritance bug where newly created landing pages picked up layout elements from a previously viewed page.

2022.1.3

• Token-Based Authentication patch (NLAuth header removal): Patch instructions were published to strip the NLAuth authorization header from TBA flows in the SCA developer tools. Without this patch, TBA may break on older SCA developer tool versions. See Oracle's Token-Based Authentication Updates for Developer Tools guide for the specific patch steps.
• Fixed landing pages not opening correctly when managed through Site Management Tools (SMT).
• Fixed a 500: UNEXPECTED_ERROR triggered when the payment card token feature was enabled for web store display.
• Fixed Checkout terms-and-conditions pages rendering default text instead of customized content.

2022.1.2

• External Checkout Only support for invoice payments: Commerce websites configured with External Checkout Only in the Payment Processing profile now correctly redirect customers to external payment pages for invoice payments. Previously, external payments were treated as alternative payments rather than the primary payment method, which blocked the redirect.
• Fixed an empty-error-message bug on the Payment Methods page when shoppers returned from an external payment method to make a correction. Shoppers previously had to re-select the payment method to continue checkout.
• Fixed SCA bundle installation failures when compiling with Node 12.21.0 and Gulp 4.0.2.
• Fixed Commerce Category record pages displaying incorrectly in Site Management Tools.
• Fixed Product Display Page (PDP) pricing not updating based on quantity.

2022.1.1

• Fixed item review author data: the author of a Web Store review was being captured as a plain string instead of a structured entity. The author is now stored per the JSON-LD schema specification, which affects structured data output for SEO.

What to do

1. Apply the TBA patch (2022.1.3): If you run SCA developer tools with token-based authentication, follow Oracle's Token-Based Authentication Updates for Developer Tools instructions to remove the NLAuth header from your TBA flow. Without this, authentication may fail in affected versions.
2. Verify External Checkout configurations (2022.1.2): If your Payment Processing profile is set to External Checkout Only, test the invoice payment redirect flow end-to-end after upgrading. Confirm customers land on the external payment page and can complete payment without errors.
3. SCA build toolchain: If you previously worked around the Node 12.21.0 / Gulp 4.0.2 bundle installation issue, you can revert your workaround after applying 2022.1.2.
4. SEO / structured data: If you consume or validate JSON-LD structured data from your web store (e.g., in Google Search Console), verify that item review author markup now renders correctly after 2022.1.1.
5. Regression-test landing pages and SMT: If you manage landing pages or Commerce Category pages through Site Management Tools, confirm they render correctly after upgrading to 2022.1.3+.
6. General: These fixes are delivered as part of the standard SuiteCommerce release cycle. Confirm your SC/SCMA/SCA bundle version reflects the latest minor release and run smoke tests across checkout, PDP pricing, and landing pages.