Implementing Web Payment Processor

Follow common Java practices to implement necessary functionality in the generated Java file. You can place it in any package. The class must extend WebPayment:

public class MyPaymentProcessor extends WebPayment {
....
}

Imports

To support H-Sphere web payment processor functionality, you must import the WebPayment class:

import psoft.epayment.WebPayment;

Additionally, you can import other classes by Psoft, gateway developers, or your own utility classes.

Required Methods

Your class must implement the following methods:

initPaymentRequestInfo - get amount and invoice id from the payment notification request and initialize the PaymentRequestInfo object.
getRedirectUrl - get payment server url to redirect the client to.
validatePaymentRequest - validate the request (notification) from the web payment processing server. Notifications need to be validated to make sure that a it's not a third party ploy to credit the account. Throw an exception if the validation fails.
getRedirectValues - return a HashMap with all parameters required for the payment request sent to the payment processing server. The HashMap will be used to create the HTTP request.

Logging

For debugging purposeses, use the following code as an example:

	    response.setContentType("text/html");
	    PrintWriter out1 = new PrintWriter(response.getWriter());
	    out1.println(transResult == 0 ? "OK" : "ERROR");
	    out1.close();

Errors or failures must be processed with the try{} and catch{} procedures.

Here is a sample Web payment processor implementation:

package psoft.hsphere.payment;

import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;


public class ToCheckout extends WebPayment {

    private static final String AUTHNET_PAYMENT_URL =
"https://www.2checkout.com/cgi-bin/Abuyers/purchase.2c";
    private static final String OLD_PAYMENT_URL =
"https://www.2checkout.com/cgi-bin/buyers/cartpurchase.2c";
    private static final String NEW_PAYMENT_URL =
"https://www2.2checkout.com/2co/buyer/purchase";

    protected PaymentRequestInfo initPaymentRequestInfo
(HttpServletRequest request) throws Exception {
	String samount = request.getParameter("total");
	if (isEmpty(samount)) {
	    samount = request.getParameter("x_amount");
	}
	String transid = request.getParameter("x_invoice_num");
	if (isEmpty(transid)) {
	    transid = request.getParameter("cart_order_id");
	}
	return new PaymentRequestInfo(request, Double.parseDouble(samount),
transid);
    }

    protected String getRequestId(HttpServletRequest request) {
	String requestId = request.getParameter("x_invoice_num");
	if (isEmpty(requestId)) {
	    requestId = request.getParameter("cart_order_id");
	}
	return requestId;
    }

    protected double getRequestAmount(HttpServletRequest request)
	    throws Exception
    {
	double amount = 0;
	String samount = "";
	try {
	    samount = request.getParameter("total");
	    if (isEmpty(samount)) {
		samount = request.getParameter("x_amount");
	    }
	    amount = Double.parseDouble(samount);
	} catch (Exception ex) {
	    throw new Exception("Unable to get amount " +
		    "from the request. Amount value: " + samount);
	}
	return amount;
    }

    protected String getRedirectUrl() throws Exception {
	String paymentUrl = "";
	int mId = Integer.parseInt((String) getValue("ID"));
	if (mId >= 200000 || "1".equals(getValue("v2_support"))) {
	    paymentUrl = NEW_PAYMENT_URL;
	} else if ("1".equals(getValue("Use_Authorize"))) {
	    paymentUrl = AUTHNET_PAYMENT_URL;
	} else {
	    paymentUrl = OLD_PAYMENT_URL;
	}
	return paymentUrl;
    }

    protected String getRedirectMethod() {
	return "POST";
    }

    protected HashMap getRedirectValues(HttpServletRequest request)
throws Exception {
	HashMap values = new HashMap();
        String amount = getFormatedAmount();

	if ("1".equals(getValue("Use_Authorize"))) {
	    values.put("x_login", getValue("ID"));
            values.put("x_amount", amount);
	    values.put("x_invoice_num", getInvoiceID());
	    values.put("x_Receipt_Link_URL", getServletPath());
	    values.put("x_Receipt_Link_Method", "POST");
	    values.put("x_Receipt_Link_Text", "Continue");
	    values.put("x_Show_Form", "PAYMENT_FORM");
	} else {
	    values.put("sid", getValue("ID"));
	    values.put("total", amount);
	    values.put("cart_order_id", getInvoiceID());
	    values.put("cart_id", getInvoiceID());
	    values.put("c_prod", getInvoiceID());
	}
	return values;
    }

    protected void validatePaymentRequest()
	    throws Exception
    {
	String customerId = getPaymentRequestInfo().getRequestValue("x_login");
	if (isEmpty(customerId)) {
	    customerId = getPaymentRequestInfo().getRequestValue("sid");
	}
	if (isEmpty(customerId)) {
	    throw new Exception ("Customer ID doesn't included into request");
	}
	if (!customerId.equals(getValue("ID"))) {
	    throw new Exception ("Incorrect customer ID is included into
request");
	}
	checkIP(this.getPaymentRequestInfo().getRemoteAddr());
    }
}