Skip to main content
Welcome to the preview portal — This is an early release of the new Doc Hub experience, with more content coming soon.
Technology Partner

Upgrade the Salesforce B2C Commerce Cartridge


  1. Download the code from the ISV Integration Toolkits section on GitHub.
  2. Zip the payments_metadata folder.
  3. Go to Administration > Site Development > Site Import & Export and upload the payments_metadata.zip file.
  4. Import the uploaded zip file.
  5. Check release notes for any configuration parameters that might have changed.

Result: The cartridge is successfully upgraded to the latest version.

Migrating to Version 2.0.0

Version 2.0.0 is a major release. When upgrading from an earlier release, review these changes:

  1. Add the new Business Manager cartridge. Add bm_cybs_sfra to the Business Manager cartridge path (it provides the Webhook Manager page). See Configure Salesforce B2C Commerce.
  2. Update the service endpoints. The endpoints have changed to https://apitest.visaacceptance.com (test) and https://api.visaacceptance.com (production).
  3. Update the Payment Credentials service URL under Administration > Operations > Services.
  4. Re-check site preferences. Preference groups were renamed to VisaAcceptance_* and regrouped. Payer Authentication, SCA, Decision Manager, and Transaction Type are now under Salesforce Default Acceptance Configuration and apply to the Salesforce default card form (Direct API) only. For Unified Checkout, configure these controls in the . Confirm your settings after importing metadata.
  5. Removed features:
    1. Flex Microform: card capture is now Unified Checkout or the Salesforce default payment form (Direct API).
    2. Standalone Google Pay: Google Pay is now offered through Unified Checkout. Standalone Apple Pay is still supported.
    3. Network Token webhook: token updates are now retrieved through the Token Management Service (TMS) API.
  6. Set up webhooks. Order updates are now driven by webhook notifications. Subscribe using the new Webhook Manager. The Salesforce jobs remain as a fallback. See Webhooks.
  7. Authentication. API authentication continues to use your REST Shared Secret and Key ID. Message-Level Encryption (MLE) uses a P12 certificate.
  8. Message-Level Encryption. The Message-Level Encryption preference VisaAcceptance_CertificateAlias has been renamed VisaAcceptance_RequestMLECertificateAlias, and VisaAcceptance_CertificateSerialNo has been removed. New configuration steps are available for Request and Response MLE, including a master MLE switch (off by default).

Last published: November 18, 2026