Project

General

Profile

Specification » History » Revision 6

Revision 5 (Soh Keong, 01/20/2021 03:50 PM) → Revision 6/11 (Soh Keong, 03/31/2021 02:58 PM)

{{toc}} 

 h1. Specification 

 h1. Activity Diagram 

 
 !flow.png! 
 !flow_UnionPay.png! 

 h1. Programming Guide 

 h2. Jar version  

 |_. version |_. Description       | 
 | 1.3         | Init                | 
 | 1.5         | Added Installment | 

 h3. Jar File Download 

 "Jar":/redmine/attachments/download/571/TaiShin-1.5.jar 
 "Properties":/redmine/attachments/download/539/taishin.properties 

 h2. 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,  
	 INST_ORDER_ID VARCHAR(15), 
	 INST_PERIOD INTEGER, 
	 INST_DOWN_PAY DECIMAL(15,2), 
	 INST_PAY DECIMAL(15,2), 
	 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*       - 
 > * *InstallPeriod*      -  

 h3. updateTransaction 

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

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