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

Message-Level Encryption


Message-Level Encryption (MLE) uses certificates to ensure that each message is securely encrypted and tied to the sender's verified identity, without needing to share secret keys in advance.

To enable Message-Level Encryption for transaction processing, configure Request MLE and Response MLE first, then go to Merchant Tools > Site Preferences > Custom Preferences > Message-Level Encryption Configuration. Set the field Enable MLE to On.

Request MLE

Request Message-Level Encryption can be set up using a Certificate Alias or through a single file using Salesforce IMPEX (import/export).

Follow these steps to set up Request Message-Level Encryption.

Certificate Alias Method

  1. Convert the Response MLE .p12 certificate to .crt format using this command: openssl pkcs12 -in <key filename>.p12 -cacerts -nokeys -out <key filename>.crt
  2. Open the converted file in a text editor and make sure CyberSource_SJC_US is the first certificate.
  3. Go to Administration > Operations > Private Keys and Certificates and import the extracted .crt file. Make a note of the alias provided after the import is completed.
  4. Go to Merchant Tools > Site Preferences > Custom Preferences > Message-Level Encryption Configuration:
    • For the field Request MLE Certificate Alias, enter the alias used when importing the CyberSource_SJC_US certificate.
    • Leave the field Request MLE - P12 file path under IMPEX blank.

Single File IMPEX Method

  1. Go to Administration > Operations > Site Development > Import & Export and upload the Response MLE .p12 certificate.
  2. Go to Merchant Tools > Site Preferences > Custom Preferences > Message-Level Encryption Configuration:
    • For the field Request MLE - P12 file path under IMPEX, enter the path under IMPEX where the certificate was uploaded: IMPEX/src/ or /on/demandware.servlet/webdav/Sites/Impex/src/mle/.
    • Leave the field Request MLE Certificate Alias blank.
  3. After the import completes, delete the .p12 file from the IMPEX directory to reduce the exposure window.

Response MLE

Response Message-Level Encryption is optional; however, if you are using Unified Checkout, the Message-Level Encryption certificate is required for the subscription to the Unified Checkout webhook response notification.

Follow these steps to set up Response Message-Level Encryption.

  1. Import the certificate: go to Administration > Operations > Private Keys and Certificates and import the .p12 certificate. You are asked to enter an Alias for the certificate and enter the password you set when creating the .p12 certificate. Make a note of the alias provided after the import is completed.
  2. Go to Merchant Tools > Site Preferences > Custom Preferences > Message-Level Encryption Configuration: for the field Private Key Alias for Response MLE and Webhooks, enter the alias you set when importing the .p12 certificate.

Next steps: return to Configure the Salesforce B2C Commerce Plugin to continue the configuration.

Last published: November 18, 2026