Netcetera Merchant Plug-In (MPI) - Release Notes - Version 1.1.0.0

Version 1.1.0.0 is a major release of the Netcetera Merchant Plug-In.

For documentation about this release please refer to the documentation site.

Compatibility

This version is not fully backwards compatible with previous versions of the Netcetera Merchant Plug-In.

Upgrade notes

  • This release introduces changes in the namespaces of the MPI Configuration and the MPI API XML schemas:
    • The versioned namespace in the MPI Configuration was removed. For future backwards compatible changes in the MPI Configuration schema you are not forced to make adjustments in your configuration (i.e. update the schema version). Any future breaking changes will be described in the upgrade notes of the corresponding release.

      Change your existing MPI Configuration and remove the namespace declarations and prefixes.

      Before:

      <mpi:MpiConfiguration xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:mpi="http://mpi.netcetera.com/configuration/1.0">
        ...
      </mpi:MpiConfiguration>

      After:

      <MpiConfiguration>
        ...
      </MpiConfiguration>
    • The versioned namespace in the MPI API was changed to a non-versioned one (http://mpi.netcetera.com). For future backwards compatible changes in the MPI API schema you are not forced to make adjustments in your MPI client code. Any future breaking changes will be described in the upgrade notes of the corresponding release.

      In case you use the XML format for communication with the MPI, make sure to use the new, non-versioned namespace. Check the sample requests on the MPI API documentation page for details.

  • Starting with this release, XIDs are exposed as Base64 encoded values for logging. If you use special tools for log file monitoring or analysis, you may have to consider this change in those tools. Refer to the logging configuration documentation and the MDC section for details.

Changes

New Features

  • Compliant with JCB J/Secure.
  • MPI API: Support for passing Purchase.date in PaReqCreationRequest.
  • MPI API: Support for passing a Base64 encoded 20 byte Purchase.xid in PaReqCreationRequest (as an alternative to the 20 byte UTF-8 encoded character string).
    Note: The MPI now only exposes the Base64 encoded XID for logging (via the MDC).
  • MPI Configuration Properties: Support for using an HTTP proxy for Directory Server communication (dsClient.proxy property).
  • MPI Configuration Properties: Support for specifying regex patterns for scheme resolution (based on the PAN; e.g. panRegex.visa property).
  • MPI Configuration: Support for specifying a password for Directory Server authentication on level Acquirer(-Bin).
  • MPI Configuration: Support for using different Directory Server endpoints depending on the authentication method (i.e. password vs. certificate authentication).

Improvements

  • The MPI dashboard is now mapped to /dashboard instead of the root path (/) to allow for easier access restriction configuration.
  • External dashboard dependencies (Bootstrap and jQuery) are now bundled with the application.
  • MPI Operation Manual: Enhanced documentation about Certificates.