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
- Convert the Response MLE
.p12certificate to.crtformat using this command:openssl pkcs12 -in <key filename>.p12 -cacerts -nokeys -out <key filename>.crt - Open the converted file in a text editor and make sure CyberSource_SJC_US is the first certificate.
- Go to Administration > Operations > Private Keys and Certificates and import the extracted
.crtfile. Make a note of the alias provided after the import is completed. - 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_UScertificate. - Leave the field Request MLE - P12 file path under IMPEX blank.
- For the field Request MLE Certificate Alias, enter the alias used when importing the
Single File IMPEX Method
- Go to Administration > Operations > Site Development > Import & Export and upload the Response MLE
.p12certificate. - 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.
- After the import completes, delete the
.p12file 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.
- Import the certificate: go to Administration > Operations > Private Keys and Certificates and import the
.p12certificate. You are asked to enter an Alias for the certificate and enter the password you set when creating the.p12certificate. Make a note of the alias provided after the import is completed. - 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
.p12certificate.
Next steps: return to Configure the Salesforce B2C Commerce Plugin to continue the configuration.
Thanks for your feedback!
Last published: November 18, 2026