• Table of contents
• Specification
• Activity Diagram
• Programming Guide
  • Jar version
    • Jar File Download
  • properties file
  • Database Table
  • Tai Shin Service
    • getURL
    • updateTransaction
  • Keystore
    • Windows
    • Linux

Specification¶

Activity Diagram¶

Programming Guide¶

Jar version¶

version	Description
1.3	Init
1.5	Added Installment

Jar File Download¶

Jar
Properties

properties file¶

• taishin.properties

1. sender
2. version
3. merchant.id
4. sub.merchant.id
5. terminal.id
6. union.pay.timeout.in.minute
7. union.pay.ip.address
8. payment.url.credit.card
9. payment.url.union.pay
10. query.url.credit.card
11. query.url.union.pay
12. cacerts.alias
13. cacerts.file
14. cacerts.Pass
15. CONNECTION_TIMEOUT
16. READ_TIMEOUT

Database Table¶

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))

Tai Shin Service¶

com.aces.ts.service.TaiShinService service = new com.aces.ts.service.TaiShinService();

getURL¶

String url = service.getURL(Connection conn, PaymentTaiShin payment)

1. conn - Database connection.
2. 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 -

updateTransaction¶

ResponseTaiShin = updateTransaction(Connection conn, HttpServletRequest request)

1. ResponseTaiShin

• errorCode -
• errorDesc -
• orderId - String
• amount - double
• currency -
• appCode -
• tranId -
• status -
• payDate - Date
• valid - boolean
• installmentOrderId -
• installmentPeriod -
• installmentDownPay -
• installmentPay -

Keystore¶

Windows¶

cd C:\java\JDK8\bin
keytool -import -file "C:\project\paymentGateway\TW\TSPG\taishin_live.cer" -keystore "E:\DevelopmentTools\java\JDK8\jre\lib\security\cacerts" -alias "taishin_live"
keytool -list -v -keystore "C:\java\JDK8\jre\lib\security\cacerts" -storepass changeit -alias "taishin_live"
keytool -delete -keystore "C:\java\JDK8\jre\lib\security\cacerts" -storepass changeit -alias "taishin_live"

Linux¶

cp /usr/local/jdk1.8.0_171/jre/lib/security/cacerts /usr/local/jdk1.8.0_171/jre/lib/security/cacerts.bak
/usr/local/jdk1.8.0_171/bin/keytool -delete -v -keystore "/usr/local/jdk1.8.0_171/jre/lib/security/cacerts" -alias "taishin" -storepass changeit
/usr/local/jdk1.8.0_171/bin/keytool -importcert -file "/data/tspg/taishin.cer" -alias "taishin" -keystore "/usr/local/jdk1.8.0_171/jre/lib/security/cacerts" -storepass changeit
/usr/local/jdk1.8.0_171/bin/keytool -list -v -keystore "/usr/local/jdk1.8.0_171/jre/lib/security/cacerts" -alias "taishin" -storepass changeit