bug fixes and doc update

Author: ohernandovisa

README.md

@@ -3,9 +3,9 @@
 
 * **Description:**  Cybersource, a Visa solution, is the only global, modular payment management platform built on secure Visa infrastructure with the payment reach and fraud insights of a massive $500B+ global processing network. You can find out more about what Cybersource does [here](https://www.cybersource.com/en-gb.html).
 * **Categories:** Payment Processing, Fraud Detection, Address Validation, Tax Computation
-* **Version:** 25.2.0
-* **Compatibility:** <span style="color:red">This version of the Cybersource cartridge is not compatible with versions of SFRA higher than Release 7.0.0. </span>
-This version can be found on the Master branch of the SFRA repository on May , 2025 <span style="color:red">This version is compatible with Salesforce B2C Commerce 22.2 release. <span>
+* **Version:** 25.3.0
+* **Compatibility:** <span style="color:red">This version of the Cybersource cartridge is not compatible with versions of SFRA Release 7.0.0. </span>
+This version can be found on the Master branch of the SFRA repository on June , 2025 <span style="color:red">This version is compatible with Salesforce B2C Commerce 22.2 release. <span>
 
 ----
 

cartridges/int_cybersource_sfra/cartridge/controllers/CYBKlarna.js

@@ -18,9 +18,6 @@ server.post('GetSession', csrfProtection.generateToken, function (req, res, next
 
     var returnObject = {};
 
-    //  Update billing address with posted form values and email param.
-    klarnaHelper.updateBillingAddress(basket);
-
     // updating Payment Transaction amount for purchase object
     COHelpers.calculatePaymentTransaction(basket);
 
@@ -56,16 +53,16 @@ server.post('GetSession', csrfProtection.generateToken, function (req, res, next
     // Handle billing address state and postal code for US and non-US addresses
     if (currentLocale.country === 'US') {
         // For US addresses, set dummy values if state or postal code is missing. Actual values will be updated later in session update.
-        billTo.setState(basket.billingAddress.stateCode || 'CA');
-        billTo.setPostalCode(basket.billingAddress.postalCode || '94043');
+        billTo.setState((basket.billingAddress && basket.billingAddress.stateCode) || 'CA');
+        billTo.setPostalCode((basket.billingAddress && basket.billingAddress.postalCode) || '94043');
     } else {
         // For non-US addresses, use the billing address values directly
-        billTo.setState(basket.billingAddress.stateCode || '');
-        billTo.setPostalCode(basket.billingAddress.postalCode || '');
+        billTo.setState((basket.billingAddress && basket.billingAddress.stateCode) || '');
+        billTo.setPostalCode((basket.billingAddress && basket.billingAddress.postalCode) || '');
     }
 
     // Create billto, shipto, item and purchase total object
-    if (!empty(basket.billingAddress.address1) || !empty(basket.defaultShipment.shippingAddress)) {
+    if (!empty(basket.billingAddress && basket.billingAddress.address1) || !empty(basket.defaultShipment && basket.defaultShipment.shippingAddress)) {
         var result = CommonHelper.CreateCyberSourceBillToObject(basket, true);
         billTo = result.billTo;
     }

cartridges/int_cybersource_sfra/cartridge/scripts/helper/CommonHelper.js

@@ -525,7 +525,7 @@ function CreateKlarnaItemObject(Basket) {
             itemObject.setProductCode('PRICE_ADJUSTMENT');
             itemObject.setProductName('PRICE_ADJUSTMENT');
             itemObject.setProductSKU('PRICE_ADJUSTMENT');
-            setKlarnaTaxAmount(itemObject, lineItem.tax.value, locale);
+            setKlarnaTaxAmount(itemObject, StringUtils.formatNumber(lineItem.tax.value < 0 ? 0 : lineItem.tax.value, '000000.00', locale));
             setTotalAmount(processor, itemObject, lineItem.basePrice.value < 0 ? 0 : lineItem.basePrice.value, locale);
             itemObject.setId(count);
         } else {

cartridges/int_cybersource_sfra/cartridge/scripts/klarna/helper/KlarnaHelper.js

@@ -5,40 +5,6 @@ var CommonHelper = require('*/cartridge/scripts/helper/CommonHelper');
 var CybersourceConstants = require('*/cartridge/scripts/utils/CybersourceConstants');
 var CybersourceHelper = require('*/cartridge/scripts/cybersource/libCybersource').getCybersourceHelper();
 
-/**
- * function
- * @param {*} basket basket
- */
-function updateBillingAddress(basket) {
-    var address1 = session.forms.billing.addressFields.address1.value;
-    var address2 = session.forms.billing.addressFields.address2.value;
-    var city = session.forms.billing.addressFields.city.value;
-    var country = session.forms.billing.addressFields.country.value;
-    var firstName = session.forms.billing.addressFields.firstName.value;
-    var lastName = session.forms.billing.addressFields.lastName.value;
-    var phone = session.forms.billing.addressFields.phone.value;
-    var postalCode = session.forms.billing.addressFields.postalCode.value;
-    var state = session.forms.billing.addressFields.states.stateCode.value;
-    var email = session.forms.billing.klarnaEmail.value;
-
-    Transaction.wrap(function () {
-        var billingAddress = basket.billingAddress;
-        if (!billingAddress) {
-            billingAddress = basket.createBillingAddress();
-        }
-        billingAddress.setFirstName(firstName);
-        billingAddress.setLastName(lastName);
-        billingAddress.setAddress1(address1);
-        billingAddress.setAddress2(address2);
-        billingAddress.setCity(city);
-        billingAddress.setPostalCode(postalCode);
-        billingAddress.setStateCode(state);
-        billingAddress.setCountryCode(country);
-        billingAddress.setPhone(phone);
-        basket.setCustomerEmail(email);
-    });
-}
-
 /**
  * function
  * @param {*} basket basket
@@ -146,7 +112,6 @@ function clearKlarnaSessionVariables() {
 }
 
 module.exports = {
-    updateBillingAddress: updateBillingAddress,
     mapKlarnaExpressCheckoutAddress: mapKlarnaExpressCheckoutAddress,
     setBillingAddress: setBillingAddress,
     convAddressObj: convAddressObj,

documentation/CyberSource Cartridge Storefront Reference Architecture Integration Guide.pdf

@@ -510,7 +510,8 @@ Step 6: Go to **Merchant Tools > Site Preferences > Custom Preferences > Cyberso
 
 | Field                            | Description                        |
 | -------------------------------- | ---------------------------------- |
-| Klarna Decision Manager Required | Enable or Disable Decision Manager |
+|enableKlarnaExpressCheckout       |Enable or Disable Klarna Express Checkout for Cart and Mini Cart |
+|Klarna Decision Manager Required | Enable or Disable Decision Manager |
 | Klarna JS API Path               | Klarna JS API Library Path         |
 | klarnaPrivateKeyAlias            | Private Key Alias of imported Key in Private Keys and Certificates |
 

documentation/markdown/Configure-payment-method.md

@@ -1,5 +1,19 @@
 ## <ins>Release History
 
+**Version 25.3.0 (June, 2025)**
+Enhancement:
+• Added support for Klarna Express Checkout from Mini Cart, Cart and Checkout pages.
+• Implemented rate limiter for saving cards during the checkout process.
+• Removed "Order-Details" and "Order-Confirm" from the cartridge and enhanced the order model. 
+
+Bug Fix:
+• Updated the default values for rate limiter fields in custom preferences. 
+• Added support for sending device information (Device Fingerprint) in the tokenization service call from My Account page.
+• Removed the hardcoded email Id sent in the tax service call.
+• Addressed dependency issue on payment methods in BM during the alteration and deletion of payment method IDs.
+• Fixed transactions failures with coupons when tax disabled.
+• Removed the CVV input field for transactions with saved cards during checkout.
+
 **Version 25.2.0 (May, 2025)**
 Enhancement: 
 • Refactored logic from the controller into a helper script and optimized controllers by integrating