Project

General

Profile

Specification » History » Version 12

Soh Keong, 07/10/2012 01:58 PM

1 1 Soh Keong
h1. Specification
2 2 Soh Keong
3
h1. Activity Diagram
4
5
Figure 1 showing the process flow from Russia mall to Uniteller Payment Gateway Page.
6
!Uniteller_GW.png!
7
8
h1. Programming Guide
9
10
h2. Resources
11
12
h3. SCM
13
14
see [[wiki#SCM]]
15
16
h3. Classes
17
18
* *main.java.com.ecosway.constants*          - CommonConstants, EMoneyType, Language, MeanType
19
* *main.java.com.ecosway.model*              - Common, PaymentResponse, Personal, Uniteller
20
* *main.java.com.ecosway.service*            - AuthorizationRequestService
21
* *main.java.com.ecosway.service.impl*       - AuthorizationRequestServiceImpl
22
* *main.java.com.ecosway.unitellerInterface* - UnitellerInterface
23
* *main.java.com.ecosway.utils*              - PropertiesUtils, SignatureUtils
24
* *ru.uniteller.type*                        - SOAPStruct_Helper, SOAPStruct
25 7 Soh Keong
* *ru.uniteller.wsdl*                        - Uniteller, UnitellerLocator, UnitellerSoapBindingStub, UnitellerSoapPort, UnitellerSoapPortProxy
26 3 Soh Keong
27
h3. properties file
28
29
* *application.properties*
30
31
   # *shop.id*       - The e-shop identifier in the Uniteller system.
32
   # *login.id*      - The login assigned to the Merchant during the account creation in the Uniteller system.
33
   # *shop.password* - The password assigned to the Merchant during the account creation in the Uniteller system.
34
   # *uniteller.url* - As an address of the payment page of the payment gateway.
35
   # *uniteller.interface.table.name* - Table Name of Uniteller Interface.
36 12 Soh Keong
   # *mean.type* - Credit Card Payment Type.
37
   # *emoney.type* - Electronic Currency Type.
38 3 Soh Keong
39 1 Soh Keong
h3. Database Table
40 3 Soh Keong
41
<pre>
42
CREATE TABLE ECOS.UNITELLER_INTERFACE (
43 8 Soh Keong
	ORDER_ID VARCHAR(18) NOT NULL, 
44 3 Soh Keong
	CHARGE_AMT DECIMAL(15,2), 
45 10 Soh Keong
	TRX_TYPE VARCHAR(20) NOT NULL, 
46
	SHOPPER_REF_NO INTEGER NOT NULL, 
47 3 Soh Keong
	COMMENT VARCHAR(255),
48 8 Soh Keong
	ERROR_MESSAGE VARCHAR(255), 
49 3 Soh Keong
	CURRENCY VARCHAR(3),
50
	ORDER_STATUS VARCHAR(100),
51 10 Soh Keong
	IS_VALID CHARACTER NOT NULL, 
52 9 Soh Keong
	LOCAL_DATETIME TIMESTAMP,
53 11 Soh Keong
	CREATE_DATETIME TIMESTAMP NOT NULL,
54 1 Soh Keong
	MODIFY_DATETIME TIMESTAMP, 
55 10 Soh Keong
	PRIMARY KEY (ORDER_ID));
56 1 Soh Keong
</pre>
57
58 3 Soh Keong
h3. Integration
59
60 8 Soh Keong
There are total 2 methods (getURL & updateStatusByOrderNo).
61 3 Soh Keong
62
*Get Uniteller URL*
63 1 Soh Keong
64 6 Soh Keong
<pre>
65 3 Soh Keong
main.java.com.ecosway.service.AuthorizationRequestService service = new main.java.com.ecosway.service.impl.AuthorizationRequestServiceImpl();
66 1 Soh Keong
67
String URL = service.getURL(Connection conn, String trxType, String orderNumber,
68 12 Soh Keong
			String currency, double amount, String urlReturn, int lifeTime,
69
			int shopperRefNo, Language language, String comment,
70
			main.java.com.ecosway.model.Personal personal);
71 3 Soh Keong
</pre>
72
73
# *conn*            - Database connection.
74
# *trxType*         - The Type of Transaction.
75
# *orderNumber*     - The unique order Number.
76
# *currency*        - The currency of the order expressed as an ISO 4217 alpha code. (Value: main.java.com.ecosway.constants.CommonConstants.CURRENCY_)
77 4 Soh Keong
# *amount*          - The purchase amount in the currency.
78
# *urlReturn*       - Page URL the Purchaser must be returned to when a transaction is performed in the Uniteller system.
79
# *lifeTime*        - The form (page) lifetime in seconds, staring from the moment it was displayed.
80
# *shopperRefNo*    - Member ID.
81
# *language*        - The interface language code of the payment page. (Value: main.java.com.ecosway.constants.Language)
82
# *comment*         - Payment comments.
83
# *personal*        - firstName, lastName, middleName, email, phone, address, country, state, city and zip.
84 6 Soh Keong
85
*Get Server Call Back Status*
86
87
<pre>
88 1 Soh Keong
main.java.com.ecosway.service.AuthorizationRequestService service = new main.java.com.ecosway.service.impl.AuthorizationRequestServiceImpl();
89 6 Soh Keong
90 9 Soh Keong
void service.updateStatusByOrderNo(Connection conn, String status, String orderNo, java.util.Date localDateTime);
91 6 Soh Keong
</pre>
92
93
# *conn*    - Database connection.
94 1 Soh Keong
# *status*  - javax.servlet.http.HttpServletRequest.getParameter("Status").
95 6 Soh Keong
# *orderNo* - javax.servlet.http.HttpServletRequest.getParameter("Order_ID")
96 9 Soh Keong
# *localDateTime* - Russia payment date and time.