Specification¶

Activity Diagram¶

Figure 1 showing the process flow from Russia mall to Uniteller Payment Gateway Page.

Figure 2 showing the process flow to get Payment Result from Uniteller Payment Gateway.

Programming Guide¶

Resources¶

SCM¶

see wiki

Classes¶

• main.java.com.ecosway.constants - CommonConstants, EMoneyType, Language, MeanType
• main.java.com.ecosway.model - Common, PaymentResponse, Personal, Uniteller
• main.java.com.ecosway.service - AuthorizationRequestService
• main.java.com.ecosway.service.impl - AuthorizationRequestServiceImpl
• main.java.com.ecosway.unitellerInterface - UnitellerInterface
• main.java.com.ecosway.utils - PropertiesUtils, SignatureUtils
• ru.uniteller.type - SOAPStruct_Helper, SOAPStruct
• ru.uniteller.wsdl - Uniteller, UnitellerLocator, UnitellerSoapBindingStub, UnitellerSoapPort, UnitellerSoapPortProxy

properties file¶

• application.properties
  1. shop.id - The e-shop identifier in the Uniteller system.
  2. login.id - The login assigned to the Merchant during the account creation in the Uniteller system.
  3. shop.password - The password assigned to the Merchant during the account creation in the Uniteller system.
  4. uniteller.url - As an address of the payment page of the payment gateway.
  5. uniteller.interface.table.name - Table Name of Uniteller Interface.
  6. end.point.url - Payment Result end point URL.

Database Table¶

CREATE TABLE ECOS.UNITELLER_INTERFACE (
    ORDER_ID VARCHAR(100) NOT NULL, 
    CHARGE_AMT DECIMAL(15,2), 
    TRX_TYPE VARCHAR(20), 
    SHOPPER_REF_NO INTEGER, 
    COMMENT VARCHAR(255),
    RESPONSE_CODE VARCHAR(5),
    RESPONSE_MSG VARCHAR(120),
    ERROR_MESSAGE VARCHAR(255),
    CURRENCY VARCHAR(3),
    CARD_TYPE VARCHAR(15),
    UNI_BILL_NUMBER VARCHAR(100),
    ORDER_STATUS VARCHAR(100),
    ERROR_CODE VARCHAR(100),
    ERROR_COMMENT VARCHAR(100),
    IS_VALID CHARACTER, 
    DATETIME TIMESTAMP,
    MODIFY_DATETIME TIMESTAMP, 
    PRIMARY KEY (ORDER_ID));

Integration¶

There are total 3 methods (getURL, getPaymentResultList & updateStatusByOrderNo).

Get Uniteller URL

main.java.com.ecosway.service.AuthorizationRequestService service = new main.java.com.ecosway.service.impl.AuthorizationRequestServiceImpl();

String URL = service.getURL(Connection conn, String trxType, String orderNumber,
            double amount, String urlReturn, int lifeTime, int shopperRefNo,
            MeanType meanType, EMoneyType eMoneyType, Language language,
            String comment, main.java.com.ecosway.model.Personal personal);

1. conn - Database connection.
2. trxType - The Type of Transaction.
3. orderNumber - The unique order Number.
4. amount - The purchase amount in the currency.
5. urlReturn - Page URL the Purchaser must be returned to when a transaction is performed in the Uniteller system.
6. lifeTime - The form (page) lifetime in seconds, staring from the moment it was displayed.
7. shopperRefNo - Member ID.
8. meanType - The credit card payment system. (Value: main.java.com.ecosway.constants.MeanType)
9. eMoneyType - The type of electronic currency type. (Value: main.java.com.ecosway.constants.EMoneyType)
10. language - The interface language code of the payment page. (Value: main.java.com.ecosway.constants.Language)
11. comment - Payment comments.
12. personal - firstName, lastName, middleName, email, phone, address, country, state, city and zip.

Get Payment Response

main.java.com.ecosway.service.AuthorizationRequestService service = new main.java.com.ecosway.service.impl.AuthorizationRequestServiceImpl();

List<PaymentResponse> paymentResponseList = service.getPaymentResultList(Connection conn,
            String orderNumber, String success, MeanType meanType,
            EMoneyType eMoneyType, String english);

1. conn - Database connection.
2. orderNumber - The unique order Number.
3. success - The operations to be included to the response.(0 – unsuccessful, 1 – successful, 2 – all)
4. meanType - The credit card payment system. (Value: main.java.com.ecosway.constants.MeanType)
5. eMoneyType - The type of electronic currency type. (Value: main.java.com.ecosway.constants.EMoneyType)
6. english -

Get Server Call Back Status

main.java.com.ecosway.service.AuthorizationRequestService service = new main.java.com.ecosway.service.impl.AuthorizationRequestServiceImpl();

void service.updateStatusByOrderNo(Connection conn, String status, String orderNo);

1. conn - Database connection.
2. status - javax.servlet.http.HttpServletRequest.getParameter("Status").
3. orderNo - javax.servlet.http.HttpServletRequest.getParameter("Order_ID")