Project

General

Profile

Specification » History » Revision 2

Revision 1 (Soh Keong, 12/08/2020 12:28 PM) → Revision 2/11 (Soh Keong, 12/08/2020 03:20 PM)

{{toc}} 

 h1. Specification 

 h1. Activity Diagram 
 !flow.png! 
 !flow_UnionPay.png! 

 h1. Programming Guide 

 h2. h3. Jar version  

 |_. version |_. Description    | 
 | 1.3         | Init             | 

 h3. Jar File Download 

 "Jar":/redmine/attachments/download/540/TaiShin-1.3.jar 
 "Properties":/redmine/attachments/download/539/taishin.properties 

 h2. h3. properties file 

 * *taishin.properties* 

 # *sender*        
         -  
 # *version*        
         -  
 # *merchant.id*    
         -  
 # *sub.merchant.id*   
         -  
 # *terminal.id*       
         -  
 # *union.pay.timeout.in.minute*   
         -  
 # *union.pay.ip.address*         
         -  
 # *payment.url.credit.card*       
         -  
 # *payment.url.union.pay*         
         -  
 # *query.url.credit.card*         
         -  
 # *query.url.union.pay*         
 # *cacerts.alias*         
 # *cacerts.file*        
 # *cacerts.Pass*     
 # *CONNECTION_TIMEOUT*     
 # *READ_TIMEOUT* 

 h2. Database Table 

 <pre> 
 CREATE TABLE TSPG_INTERFACE ( 
	 ORDER_ID VARCHAR(15) NOT NULL,  
	 TRX_TYPE VARCHAR(5),  
	 SHOPPER_REF_NO INTEGER,  
	 CURRENCY VARCHAR(3), 
	 CHARGE_AMT DECIMAL(15,2),  
	 TSPG_PAYMENT_TYPE INTEGER, 
	 APP_CODE VARCHAR(8),  
	 STATUS VARCHAR(2),  
	 ERROR_CODE VARCHAR(5),  
	 ERROR_DESC VARCHAR(100),  
	 IS_VALID CHARACTER NOT NULL,  
	 TRAN_ID VARCHAR(30), 
	 PAY_DATE TIMESTAMP,  
	 CREATE_DATETIME TIMESTAMP NOT NULL,  
	 MODIFY_DATETIME TIMESTAMP,  
	 PRIMARY KEY (ORDER_ID)) 
 </pre>     


 h2. Tai Shin Service 

 <pre> 
 com.aces.ts.service.TaiShinService service = new com.aces.ts.service.TaiShinService(); 
 </pre> 

 h3. getURL 

 <pre> 
 String url = service.getURL(Connection conn, PaymentTaiShin payment) 
 </pre> 

 # *conn*                     - Database connection. 
  
 # *payment*          **         - PaymentTaiShin object. 
 > * *orderId*            - Order ID. 
 > * *amount*             - Transaction amount.  
 > * *currency*           - com.aces.ts.common.CommonConstants.CURRENCY_CODE_TAIWAN 
 > * *trxType*            - 
 > * *tsPaymentMethod*    - com.aces.ts.common.CommonConstants.PARAM_PAY_TYPE_CREDIT_CARD | PARAM_PAY_TYPE_UNION_PAY 
 > * *layout*             - com.aces.ts.common.CommonConstants.PARAM_LAYOUT_NORMAL_WEB | PARAM_LAYOUT_MOBILE_WEB 
 > * *description*        - 
 > * *captFlag*           - com.aces.ts.common.CommonConstants.PARAM_CAPT_FLAG_ASYNCHRONOUS | PARAM_CAPT_FLAG_SYNCHRONOUS 
 > * *resultFlag* # **         - com.aces.ts.common.CommonConstants.PARAM_RESULT_FLAG_NO_DETAILS | PARAM_RESULT_FLAG_WITH_DETAILS 
 > * *browserReturnURL* - 
 > * *serverReturnURL*    - 
 > * *shopperRefNo*       - 

 h3.  

 <pre> 
 ResponseTaiShin updateTransaction(Connection conn, HttpServletRequest request) 
 </pre> 

 # *ResponseTaiShin* 
 > * errorCode -  
 > * errorDesc -  
 > * orderId     - String 
 > * amount      - double 
 > * currency    -  
 > * appCode     - 
 > * tranId      -  
 > * status      -  
 > * payDate     - Date 
 > * valid       - boolean