This method allows users with an SCMP payment system to maintain the SCMP system while using the SO endpoint. The SCMP payloads are converted into an Simple Order payload and sent to the associated Simple Order endpoint. When the Simple Order payload is returned, the payload is then converted back into SCMP for processing by the system. The image below outlines the message path:
An example program for C++, .NET, and PHP are available in the GitHub Sample Code repository.

Prerequisites

There are no prerequisites for establishing the Simple Order Payload Conversion.

Establish the Simple Order Payload Conversion

  1. Add the SCMP sample client program to your payment system. These files can be found in the GitHub Sample Code repository.
  2. Update these values for the
    app.config
    file:
    • merchantID
      : set this to your production merchant ID used for commerce.
    • keysDirectory
      : the file path to the P12 certificate generated previously.
    • password
      : the P12 certificate password.
    • keyAlias
      : the name of your MID.
    Other values may be set at your discretion. Use the comments within the file to determine which values you wish to change.
  3. After the SCMP payment software creates a request payload, run the
    processRequest
    method found in the
    Util.cs
    file against that payload.
    This method converts the SCMP payload into an Simple Order payload and forwards the Simple Order payload to the correct Simple Order endpoint. When the Simple Order reply payload is received, the method will then convert the payload back into an SCMP payload for normal processing within the system.