Add a new payment or refund method

If we are adding a new payment method or refund method, we must update the WebSphere Commerce database tables that contain information about the payment methods or refund methods that the store will use. The business policy tables do not contain information about the type of payment or refund actions or rules the Payments subsystem will use. They identify the payment and refund methods. The payment and refund actions are defined by configuring XML files.

Task info

Whenever a new payment or refund method is added to a store, a business policy with the Payment or ReturnPayment type must be created in the business POLICY table (with corresponding entries in the POLICYDESC table), and the POLICYCMD table will be inserted a set of payment policy commands. For every new entry added to the POLICY table, the value for the Business Policy Name field must match the payment (or refund) method ID configured in payment rules (the paymentMethod value in the PaymentMethodConfigurations.xml file, or the refundMethod value in the RefundMethodConfigurations.xml file).

Procedure

1. If your Payment methods is not supported, create a new payment or refund method configuration for the payment or refund method in PaymentMethodConfigurations.xml or RefundMethodConfigurations.xml.

2. Configure the payment rules we want to use with the payment method or refund method by editing the PaymentMappings XML file.

3. For B2B stores, set up any necessary payment terms and conditions.

4. Modify the store JSP page to use JSP code snippets that support the payment methods. See Sample: Payment method JSP snippets. Generally, a new payment method will require a new JSP code snippet.

5. Configure the payment plug-in you intend to use.

Related concepts
Payment financial transaction state
Plug-in exception handling and transaction roll-back

Related reference
Payment plug-in specification