nl.gx.webmanager.handler.forms.routing
Class OgoneRouter

java.lang.Object
  nl.gx.webmanager.handler.forms.foundation.FormHandlerBase
      nl.gx.webmanager.handler.forms.routing.OgoneRouter

All Implemented Interfaces:

FormComponent, Router

public class OgoneRouter
extends FormHandlerBase
implements Router

Redirect the browser to the Ogone website for payment. The URL that is used, is built up from the given parameters.

Variable	Type	Mode	Default	Description
endofflow	Parameter	Required	false	If true, the flow XML will be removed from session.
PSPID	Parameter	Required	-	Affiliation number of the merchant at Ogone e-Commerce.
currency	Parameter	Required	-	Currency of the payment (code ISO alpha: EUR, USD, GBP, CHF, ...).
language	Parameter	Required	-	Language of the buyer (languages available now: English en_US, French fr_FR, Dutch nl_NL, Italian it_IT, German de_DE, Spanish es_ES, Norwegian no_NO).
title	Parameter	Required	-	Text that appears at the top of the page.
bgcolor	Parameter	Required	-	Background color, white by default.
txtcolor	Parameter	Required	-	Text color, black by default.
tblbgcolor	Parameter	Required	-	Background color of the tables where Ogone inserts the payment forms, white by default.
tbltxtcolor	Parameter	Required	-	Text color, inside the tables, black by default.
buttonbgcolor	Parameter	Required	-	Background color of the submission button.
buttontxtcolor	Parameter	Required	-	Text color of the submission button.
logo	Parameter	Required	-	Name of a .gif or .jpg picture placed at the top of the page. This picture must have been sent to support@ogone.com beforehand.
fonttype	Parameter	Required	-	Font family, Verdana by default.
tp	Parameter	Required	-	URL of the dynamic template page that will serve as a skeleton to send the response to the buyer. If this parameter is not transmitted, Ogone e-Commerce will use a neutral page.
submit2	Parameter	Required	-	Text on the [Submit] button in Ogone.
accepturl	Parameter	Required	-	URL of the page where to redirect the buyer when the payment is accepted (or is waiting to be accepted).
declineurl	Parameter	Required	-	URL of the page where to redirect the buyer when the payment is rejected. The acquirer only rejects the payment after more than the maximum of authorized tries.
exceptionurl	Parameter	Required	-	Is used when the payment result is uncertain.
cancelurl	Parameter	Required	-	Is used when the buyer cancelled the payment.
homeurl	Parameter	Required	-	URL of your home page. When the payment is accepted, your buyer is invited to return to this URL.
catalogurl	Parameter	Required	-	URL of your catalogue. When the payment is accepted, your buyer is invited to return to this URL.
orderID	Parameter	Required	-	Number of the order: important! The system checks that a payment is not requested twice for the same order.
amount	Parameter	Required	-	Amount to be paid MULTIPLIED BY 100. The format of the amount must not contain any decimals or other separator, but only numbers. Examples: 100.00 becomes 10000, 100.25 becomes 10025, 1,250.32 becomes 125032
cn	Parameter	Required	-	Name of the buyer.
email	Parameter	Required	-	E-mail address of the buyer.
ownerZIP	Parameter	Required	-	ZIP code of the card owner.
owneraddress	Parameter	Required	-	Street/number/.. of the card owner.
ownertown	Parameter	Required	-	Town of the card owner.
ownercty	Parameter	Required	-	ISO code of the buyer's country (two characters). If the 'Fraud detection option' is activated, this parameter is used to show only the payment method relevant to the buyer's country.
com	Parameter	Required	-	A free description of the order.
complus	Parameter	Required	-	A value sent back to the merchant's website in the post-sale request. This allows the e-commerce application of the merchant to automate the processes for status updating, e-mail confirmation to the buyer, stock management and immediate downloading of intangible goods.
paramplus	Parameter	Required	-	A value sent back to the merchant's website in the post-sale request. (see 'complus')
ogoneurl	Parameter	Required	-	URL of the Ogone service.

Example usage:

• Use Ogone for a payment.

Field Summary

Fields inherited from class nl.gx.webmanager.handler.forms.foundation.FormHandlerBase

DEFAULT_STATEMENT_TIMEOUT, log, staticlog

Constructor Summary

OgoneRouter()

Method Summary

RoutingResult	doRouting(FormDefinition form, State formState, javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res) Performs routing based on the form definition and the values of the client.
void	init(FormComponentConfig config) Passes the initialization parameters to the component.

Methods inherited from class nl.gx.webmanager.handler.forms.foundation.FormHandlerBase

close, close, close, executeInsertWithIdentityMSSQLMYSQL, executeInsertWithIdentityOracle, executeIntegerQuery, executeIntegerQuery, executeIntegersQuery, executeIntegersQuery, executeQuery, executeStringQuery, executeUpdate, fillValues, getDataSource, setArguments, setArguments

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OgoneRouter

public OgoneRouter()

Method Detail

init

public void init(FormComponentConfig config)
          throws InitializationException

Description copied from interface: FormComponent

Passes the initialization parameters to the component.

Specified by:

init in interface FormComponent

Parameters:

config - The FormComponentConfig object that contains configutation information for this component.

Throws:

InitializationException - If initialization failed

doRouting

public RoutingResult doRouting(FormDefinition form,
                               State formState,
                               javax.servlet.http.HttpServletRequest req,
                               javax.servlet.http.HttpServletResponse res)

Description copied from interface: Router

Performs routing based on the form definition and the values of the client.

Specified by:

doRouting in interface Router

Parameters:

form - The definition of the current form flow

formState - The object representing the state of the client filling out a form.

req - The http servlet request

res - The http servlet response

Returns:

The routing result for the form, or null if the router doesn't match