Administer > Manage WebSphere Commerce features > Payments subsystem > Configure payment plug-ins
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 v2.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. IBM recommends 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.
Related concepts
Related tasks
Configure the Software Express plug-in
Import the Software Express plug-in
Customize the Software Express plug-in
Create the policy for the payment method
Configure payment methods for the Software Express plug-in
Configure a merchant to access the Software Express SiTef gateway
Test the Software Express plug-in
Deploy the Software Express plug-in to runtime