Who Should Read This

This article is for customers who are currently using Cybersource as their payment processor.

Kulturra has developed a new Cybersource integration package that uses the REST API. This update is in response to Cybersource’s announcement that they will no longer support username and password-based authentication for merchants using the SOAP toolkit key. Rather than transitioning to the new P12 certificate-based authentication for SOAP, Kulturra is moving to the more modern and secure REST API, which uses HTTP Signature authentication with a shared secret key.

Why the Upgrade Is Required

Cybersource has officially announced that it will stop supporting the SOAP username and password-based  authentication method. Any API requests made using this method after the cutoff dates will be rejected. To ensure uninterrupted payment processing, all Cybersource users must upgrade to the REST API integration.

Key Deadlines

To comply with Cybersource's timeline, please complete your upgrade before the following dates:

• Sandbox Environment: September 1, 2025

• Production Environment: September 15, 2025

After these dates, SOAP API requests using the username/password method will fail.

Steps to Upgrade

Please follow the steps below to complete your migration to the new REST API integration.

Sandbox (Testing Phase)

1. Install in Sandbox – Please install the latest version of our app (v13.26)

2. Generate Sandbox Credentials – Log in to the Cybersource Sandbox Business Center, navigate to Payment Configuration > Key Management, and generate a REST – Shared Secret key. Download the .pem file and password, and store them securely.

3. Configure in Salesforce (Payment Center Settings) – Create a new payment processor named CybersourceREST in your Salesforce Sandbox. Enter the sandbox Merchant ID, API Key ID, Shared Secret and Transaction Key ensuring it’s in test mode.

4. Test Transactions – Use Cybersource Test Data to process test transactions. Verify the results in Salesforce and in the Cybersource Sandbox Business Center.

Production (Go-Live Phase)

1. Install in Production – Please install the same version of our app in your Salesforce Production org.

2. Generate Production Credentials – Log in to the Cybersource Production Business Center and generate a REST – Shared Secret key and Transaction Key. Download the .pem file and password and store them securely.

3. Configure in Salesforce (Payment Center Settings) – Create a new CybersourceREST processor in Salesforce Production with your production Merchant ID, API Key ID, Shared Secret and Transaction Key. Mark it as Live and set it as the Default processor, if applicable.

4. Validate – Run a small live transaction to confirm the setup. New transactions will process exactly as before but through the secure REST API.

How to Fix the "Connection Failed" Error

If you encounter a “Connection Failed” error, you can follow the steps below to apply a workaround:

1. Go to Setup in Salesforce.

2. In the Quick Find box, type Remote, then click on Remote Site Settings.

3. Locate the CyberSource remote site entry.

4. Click Edit on:

• https://api.cybersource.com if you are in the Production Environment, or

• https://apitest.cybersource.com if you are in the Sandbox Environment.

5. Check the Active checkbox and hit Save.

Following these steps ensures that Salesforce can connect to the CyberSource service, which usually resolves the connection issue.

Need More Help?

You can find additional details about setting up Cybersource in this article.