應用場景
- Step 1. POS:呼叫刷卡機進行交易結帳作業。
- Step 2. 刷卡機:接受訂單並檢核資料,進行信用卡結帳後並回傳作業結果。
注意事項:
- 刷卡機需在主畫面才能接收POS指令
- POS等待處理中 (timeout總秒數至少要60秒逾時)
交易流程圖
請求電文參數說明 (Data)
Trans Type String(2)
交易別 必填
位置1
- 50 Settlement 結帳交易
Host ID String(2)
銀行別 必填
位置3
- 01 信用卡
Invoice Number String(6)
調閱編號
位置5
- 請填空白
Card Number String(19)
信用卡卡號
位置11
- 請填空白
CUP Flag String(2)
銀聯交易 必填
位置30
- 請填 00 一般交易
Trans Amount String(12)
交易金額 必填
位置32
- 右靠、左補0,包含兩位小數, 不包含小數點
- 金額請固定傳0
Trans Date String(6)
交易日期
位置44
- 請填空白
Trans Time String(6)
交易時間
位置50
- 請填空白
Approval Number String(6)
授權碼
位置56
- 請填空白
ECR Response Code String(4)
通訊回應碼
位置62
- 請填空白
Terminal ID String(8)
端末機代號
位置66
- 請填空白
Merchant ID String(15)
商店代號
位置74
- 請填空白
EC Order Number String(20)
綠界授權單號
位置89
- 請填空白
Store ID String(18)
櫃號 選填
位置109
- 請填空白
Card Type String(2)
卡片代碼
位置127
- 請填空白
Redeem Amount String(12)
折抵金額
位置129
- 請填空白
Redeem Point String(10)
折抵點數
位置141
- 請填空白
Redeem Balance String(10)
剩餘紅利點數
位置151
- 請填空白
Installment Period String(2)
分期期數
位置161
- 請填空白
Down Payment Amount String(12)
首期金額
位置163
- 請填空白
Down Payment Amount String(12)
每期金額
位置175
- 請填空白
Encrypted Card Number String(50)
電子發票加密卡號
位置187
- 請填空白
POS Number String(20)
POS設備編號 有條件必填
位置237
- 20碼,左靠、右補空白
Reserve String(236)
保留
位置257
- 請填空白
POS Request Time String(14)
收銀機系統時間 必填
位置493
- 西元年二十四小時制YYYYMMDDHHMMSS
Request Hash Value String(40)
發送資料雜湊值 必填
位置507
- 把欄位1〜欄位24,使用Sha-1演算法得出20個Bytes的Hash Value,然後轉為ASCII字元為40個Bytes
EDC Response Time String(14)
刷卡機系統時間
位置547
- 請填空白
Response Hash Value String(40)
回應資料雜湊值
位置561
- 請填空白
請求電文參數說明範例 (一般交易)
5001 00000000000000 10234567891023456789 202305041346263c539a2807ce8cf316d51f1b1142094eae37a3ed
回覆電文參數說明(Data)
Trans Type String(2)
交易別
位置1
- 為空白
Host ID String(2)
銀行別
位置3
- 為空白
Invoice Number String(6)
調閱編號
位置5
- 為空白
Card Number String(19)
信用卡卡號
位置11
- 為空白
CUP Flag String(2)
銀聯交易
位置30
- 為空白
Trans Amount String(12)
交易金額
位置32
- 為空白
Trans Date String(6)
交易日期
位置44
- 為空白
Trans Time String(6)
交易時間
位置50
- 為空白
Approval Number String(6)
授權碼
位置56
- 為空白
ECR Response Code String(4)
通訊回應碼
位置62
由刷卡機回傳
- 0000 Approved 授權
- 0001 Error 拒絕
- 0002 Call Bank 請聯絡銀行
- 0003 Communication Error 通訊失敗
Terminal ID String(8)
端末機代號
位置66
- 為空白
Merchant ID String(15)
商店代號
位置74
- 為空白
EC Order Number String(20)
綠界授權單號
位置89
- 為空白
Store ID String(18)
櫃號
位置109
- 為空白
Card Type String(2)
卡片代碼
位置127
- 為空白
Redeem Amount String(12)
折抵金額
位置129
- 為空白
Redeem Point String(10)
折抵點數
位置141
- 為空白
Redeem Balance String(10)
剩餘紅利點數
位置151
- 為空白
Installment Period String(2)
分期期數
位置161
- 為空白
Down Payment Amount String(12)
首期金額
位置163
- 為空白
Down Payment Amount String(12)
每期金額
位置175
- 為空白
Encrypted Card Number String(50)
電子發票加密卡號
位置187
- 為空白
POS Number String(20)
POS設備編號
位置237
依請求傳入參數值回傳
Reserve String(236)
保留
位置257
為空白
POS Request Time String(14)
收銀機系統時間
位置493
依請求傳入參數值回傳
Request Hash Value String(40)
發送資料雜湊值
位置507
依請求傳入參數值回傳
EDC Response Time String(14)
刷卡機系統時間
位置547
Response Hash Value String(40)
回應資料雜湊值
位置561
回覆電文參數說明範例 (結帳)
0000 10234567891023456789 202305041346263c539a2807ce8cf316d51f1b1142094eae37a3ed2023050413462674CB4AD91C2A05920B8B99E3344D4D78260C0964