On This Page

Important: SOAP Toolkit Update for PHP Users

As part of ongoing Security Enhancements, we are planning to upgrade SOAP API authentication to P12 authentication. This upgrade is currently available for Java, C#, C++, and PHP.

You can upgrade to P12 Authentication in your SOAP toolkit by doing the following:

Create a P12 certificate.

Update the files in your project directory.

Add your certificate information to a toolkit.properties
file in your project directory.

Update your pom.xml
file.

You must upgrade the SOAP authentication to use P12 by these dates.

Test
: April 14, 2025

Production
: May 13, 2025

This update is currently available only for the Java, PHP, C++, and C# SOAP Toolkits. The updated SDK is available here on GitHub:

Other toolkits will be available in January 2025.

This Java SOAP Toolkit update works only with WSDL or XSD 1.219 or earlier.

Available Environments

This update is available in these environments:

Test
: https://apitest.cybersource.com

Production
: https://apitest.cybersource.com

PHP

PHP Prerequisites

You must create a P12 certificate. See the REST Getting Started Developer Guide
.

With this change to use a P12 certificate in your PHP SOAP toolkit configuration, the new requirements for your application will be:

PHP 5.6x and higher

PHP SOAP extension

PHP OpenSSL extension

PHP Migration Steps

Follow these steps to upgrade your existing PHP code:

Update the following service URL (

WSDL_URL

) in your code:

https://ics2wstest.ic3.com/commerce/1.x/transactionProcessor/CyberSourceTransaction_N.NNN.wsdl

N.NNN
is the latest server API version.

Copy these files to your project directory:

ExtendedClientWithToken.php

PropertiesUtility.php

SecurityUtility.php

FInd these lines in your existing code:

$soapClient = new ExtendedClient(WSDL_URL, array());

Replace them with these lines:

$soapClient = new ExtendedClientWithToken(
    WSDL_URL,
    array(
        'SSL' => array(
                'KEY_ALIAS' => 'YOUR KEY ALIAS',
                'KEY_FILE' => 'YOUR CERTIFICATE FILE',
                'KEY_PASS' => 'YOUR KEY PASS',
                'KEY_DIRECTORY' => 'PATH TO CERTIFICATES'
            )
        )
);

Update the necessary values for these fields in your code:

MERCHANT_ID

KEY_ALIAS

KEY_FILE

KEY_PASS

KEY_DIRECTORY

Add your P12 certificate to the

KEY_DIRECTORY

This

KEY_DIRECTORY

location must be accessible to your code. Ensure that your code has permission to read this location.

Run the code:

php <sample_PHP_file>

(Optional) You can confirm that your configuration is updated successfully by confirming that your request was authenticated using a Bearer token. To confirm, add this command after line 109 in the ExtendedClientWithToken.php
file:

print_r($request);