Introduced in Feature Pack 1

Software Express plug-in

To integrate WebSphere Commerce with the Software Express SiTef payment gateway use the Software Express plug-in. The Software Express plug-in is provided as sample code, which can be implemented only with the Brazil starter store.

The sample code has been tested on the following platforms:
  • Windows operating system 64-bit and WebSphere Application Server 64-bit
  • Windows operating system 32-bit and WebSphere Application Server 32-bit
  • XLinux 64-bit and WebSphere Application Server 32-bit/64-bit

The Software Express plug-in follows the Payment plug-in specification.

The Software Express plug-in supports the following payment transactions:
Approve
The approve method implementation communicates with the Software Express payment gateway to authorize that the funds required for the online transaction are available. The action used is MKT_PRE_AUTHORIZATION.
Deposit
The deposit method implementation communicates with the Software Express payment gateway to capture the payment for the order. The action used is MKT_PRE_AUTHORIZATION_CAPTURE.
Reverse approval
The reverseApproval method implementation communicates with the Software Express payment gateway to void an approval. The action used is MKT_PRE_AUTHORIZATION_REVERSAL.
Credit
The credit method implementation communicates with the Software Express payment gateway to issue a refund to return money to the customer. The action used is MKT_SITEF_CANCELLING.
The Software Express plug-in does not support the following payment transactions:
  • Reverse deposit
  • Reverse credit
  • Validate payment instruction
If any of these APIs are called, the FunctionNotSupportedException is thrown.
The plug-in is based on the LibSitef DLL Version 2.04 Technical Specification. The plug-in communicates with Software Express using the SiTef interface, which consists of a JAR file and DLL/SO file. The JAR contains a Java class that communicates with the LibSitef DLL using the Java Native Interface (JNI). Contact Software Express to get the required version of the specification and the DLL/SO file:

For the sample code of the SiTef plug-in, SiTefPluginBean is the main class where the approve(), deposit(), reverseApprove() and credit() methods have been implemented according to the specification. These have been tested against the SiTef Simulator provided by Software Express. It is recommended that you test the plug-in against the real SiTef payment gateway instead of the simulator before you use the plug-in for any online stores.