WCPayments plug-in
TheWCPayments plug-in implements the Payment plug-in specification to process payment actions (financial transactions). TheWCPayments plug-in acts as a bridge to WebSphere Commerce Payments Multipayment Framework and the use of payment cassettes.
TheWCPayments plug-in interacts with the WebSphere Commerce Payments Multipayment Framework such that it is compatible with earlier versions of Payments cassettes.
The following table describes the transaction types and cassettes supported by theWCPayments plug-in:
Transaction type | Description |
---|---|
Offline payment | TheWCPayments plug-in enables offline transactions
to be recorded by using the following payment cassettes:
|
VisaNet financial processing system | Merchants can send Internet credit card transactions to the VisaNet system for processing, by using the Cassette for VisaNet. The Cassette for VisaNet supports credit card processing by using the Vital Processing Services or First Horizon Merchant Services networks. |
BankServ payment gateway to interface with the Automated Clearing House (ACH) Network | Processes online electronic checks by the Cassette for BankServACH. |
Paymentech payment gateway | Processes and records credit card and non-PIN based debit card payments by the Cassette for Paymentech. The Cassette for Paymentech enables real-time transactions to be sent to the Paymentech system for processing. |
Credit state handling
The WCPayments plug-in processes payment and credit states according to the Payment plug-in specification, with the following exception: TheWCPayments plug-in always sets the transaction pending in the payment APIs and uses the query APIs to get process information from WebSphere Commerce Payments. To illustrate, theWCPayments plug-in implements the interface QueryablePlugin, that is, getPayment() is supported by this plug-in. When the getPayment() API of the Payment plug-in controller is called, getPayment() ofWCPayments plug-in is called. This queries the payment status in WebSphere Commerce Payments. Then the Payment plug-in controller updates the payment related tables according to this query results and returns the payment object.
Contents and location
TheWCPayments plug-in package contains:
- A stateless session bean:
- com.ibm.commerce.payments.plugin.WCPayments .bean.WCPaymentsPluginBean
- com.ibm.commerce.payments.plugin.WCPayments .bean.WCPaymentsPlugin
- com.ibm.commerce.payments.plugin.WCPayments .bean.WCPaymentsPluginBeanHome
- PluginDeployment.xml - the payment plug-in deployment descriptor for theWCPayments plug-in which defines the plug-in to WebSphere Commerce Payments.
- A resource bundle for theWCPayments plug-in error messages.
Lists the error messages associated with primary and secondary return codes.
- Cashier profiles used by theWCPayments plug-in. TheWCPayments plug-in uses the following Cashier profiles:
The JAR file for the plug-in and plug-in deployment descriptor are located in the following directories:
- WC_eardir/Payments_Plugin_WebSphere Commerce Payments.jar
- WC_eardir/xml/config/payments/ppc/plugins/WCPayments/PluginDeployment.xml
- WC_eardir/Payments_Plugin_WCPayments .jar
- WC_eardir/xml/config/payments/ppc/plugins/WCPayments/PluginDeployment.xml
Address Verification System (AVS) code processing with the WCPayments plug-in
After an approve or an approveAndDeposit financial transaction, theWCPayments plug-in issues a query command (QUERYPAYMENTS) to obtain the AVS common code for the newly created payment and sends the code to the WebSphere Commerce Payments. If an AVS code exists (it is neither null nor zero), the plug-in sets a flag to inform the WebSphere Commerce Payments that a warning exists for the approval transaction. The WebSphere Commerce Payments then transfers the AVS code and the warning flag to the Payment rules engine.
Relationship of payment instructions to WebSphere Commerce Payments Multipayment Framework orders
The following diagram shows the payment object relationship of the Payment rules engine to theWCPayments plug-in and WebSphere Commerce Payments multipayment framework.
As shown in the diagram, a Payment instruction in payment rules layer is associated with a payment instruction in theWCPayments plug-in layer. Payment instruction information is stored by Payment plug-in controller. For theWCPayments plug-in, additional mapping data is also provided to enable communication to take place with the WebSphere Commerce Payments framework data model. The payment instruction information passed results in an order with associated payment and credit information in WebSphere Commerce Payments Multipayment Framework layer.
Every time the API of approve ofWCPayments plug-in is called, an order with the randomly generated ID is created in Multipayment Framework layer. A payment is created in the Multipayment Framework layer. Then, the approve transaction is run against this payment in Multipayment Framework layer.