Specification¶

Activity Diagram¶

Figure 1 showing the process flow from Mexico mall to TNS Payment Gateway Page.

Figure 2 showing the process flow of TNS Payment Gateway redirect back to Mexico Mall.

Programming Guide¶

Resources¶

SCM¶

see wiki

Classes¶

• my.com.eCosway.tns.commons - CommonConstants
• my.com.eCosway.tns.model - Transaction, TransCommon, TransResponse
• my.com.eCosway.tns.service - TNSService (interface)
• my.com.eCosway.tns.service.impl - TNSServiceImpl (implementation of interface)
• my.com.eCosway.tns.tnsInterface - TNSInterfaces (Data Persistence)
• my.com.eCosway.tns.utils - SecureHash, URLUtils
• test.my.com.eCosway.tns.utils - SecureHashTest, URLUtilsTest (JUnit Test)

properties file¶

• jdbc.properties
  1. tns.interface.table.name - table name of TNS interface

• log4j.properties
• transaction.properties
  1. vpc_Version - The version of the Virtual Payment Client API being used.
  2. vpc_Command - Indicates the desired operation to be performed.
  3. vpc_AccessCode - Authenticates the merchant on the Payment Server.
  4. vpc_Merchant - The Merchant ID identifies the merchant account against which settlements will be made.
  5. vpc_SecureHash - A secure hash which allows the Virtual Payment Client to authenticate the merchant and check the integrity of the Transaction Request.
  6. vpc_SecureHashType - The type of hash algorithm used to generate the secure hash.
  7. vpc_ReturnAuthResponseData - Specifies whether the authorisation response data must be included in the Transaction Response.
  8. tns_url - Used to redirect user to TNS Payment Page.

Database Table¶

CREATE TABLE ECOS.TNS_INTERFACE (
                  ORDER_ID VARCHAR(100) NOT NULL, 
                  AMOUNT INTEGER, 
                  TXN_TYPE VARCHAR(20), 
                  MEMBER_ID VARCHAR(20), 
                  ERROR_MESSAGE VARCHAR(255), 
                  RESPONSE_CODE CHARACTER, 
                  RECEIPT_NO VARCHAR(20), 
                  TRANSACTION_NO INTEGER, 
                  AUTHORIZE_ID VARCHAR(6), 
                  CARD_TYPE VARCHAR(2), 
                  TRANSACTION_IDENTIFIER VARCHAR(20), 
                  IS_VALID CHARACTER, 
                  LAST_UPDATED TIMESTAMP, 

                  PRIMARY KEY (ORDER_ID));

Integration¶

TNSService service = new TNSServiceImpl();

String response = service.sendToTNS(String orderNo, int amount, String locale,
            String returnURL, String transactionType, String shopperRefId);

1. orderNo - The unique order No (1-40 alphanumeric).
2. amount - The amount of the transaction (1-12 numeric).
3. locale - Language used on the Payment Server Page (2-5 alphanumeric).
4. returnURL - Used by Payment Server to redirect the user back to merchant's web site.
5. transactionType - The Type of Transaction.
6. shopperRefId - Member ID