.NET Payment System Upgrade

This section describes how to transition your SCMP payment system to send and receive HTTPS Simple Order API transmissions. Upgrading your payment system to Simple Order requires you to download an API key from the
Business Center
.

Enable SCMP-to-Simple Order Conversion

The conversion kit method enables users with an SCMP payment system to maintain their SCMP system while using the Simple Order endpoint. When you send an SCMP request to
Cybersource
, the request is converted into a Simple Order request and then sent to the corresponding Simple Order endpoint. When
Cybersource
returns a Simple Order response, the response is converted into SCMP for your system to process it. This image demonstrates the conversion process:

Figure:

SCMP-to-Simple Order Conversion

Setting Up SCMP-to-Simple Order Conversion

Follow these steps to set up SCMP-to-Simple Order conversion.
  1. Add the SCMP conversion kit to your payment system. Retrieve the conversion kit files from the
    scmp
    folder in GitHub:
  2. Update these values in your
    app.config
    file. Retrieve the
    app.config
    file from the
    scmp
    folder in GitHub:
    • merchantID
      : Set to your production merchant ID used for commerce.
    • keysDirectory
      : Set to the file path that leads to your P12 certificate.
    • keyAlias
      : Set to your merchant ID (MID) name.
    • password
      : Set to your P12 certificate password.
    <add key="cybs.merchantID" value="" /> <add key="cybs.keysDirectory" value="" /> <add key="cybs.keysAlias" value="" /> <add key="cybs.Password" value="" />
    You can set other files at your discretion. See the comments in the
    README.md
    file to determine which values to change:
  3. After your SCMP payment software creates a request message, run the
    processRequest
    method found in the
    Util.cs
    file against that request.

Result

When you send an API request to
Cybersource
, the
processRequest
method converts your SCMP request into a Simple Order request. It then sends the converted request to the correct Simple Order endpoint. When you receive a Simple Order response from
Cybersource
, the response is converted into SCMP for your payment system to process.