Skip to content

Taiwan Pay

Description

Taiwan Pay付款。

Resource

POST /v1/payment/taiwan/pay

Authorization

採用 OAuth 2.0 Bearer Token,詳細使用流程請參考 Auth Login

Request Body Parameters

Name Type Description
shop_id string 分店編號
terminalId string 終端號(機號)
orderNumber string 訂單編號
amount int 交易金額(含小數兩位,系統自帶),例100->10000
qrcode string 消費者出示錢包一維碼(BarCode)/二維(QRCODE)字串
retry_time int 重試序號(若有進行重新請求付款的重試次數)
(optional)

Request

{
    "shop_id" :"TWBa01",
    "terminalId":"0101",
    "orderNumber":"000001202109060009",
    "amount":29,
    "qrcode" :"96BBSACAAAEAIEVBEZRpEg",
    "retry_time": 0
}

store_id、endpointCode、verifycode為系統必填,Taiwan Pay提供

Response-華南版

{
  "storeId": "008123456780001",
  "endpointCode": "00000001",
  "terminalId": "00000001",
  "orderNumber": "101708100123456",
  "txnDir": "RQ",
  "txnDateTime": "20170810150005",
  "txnAmt": "20000",
  "txnCurrency": "901",
  "txnSeqno": "12345678",
  "txnAccNO": "54321",
  "respCode": "4001",  
  "respDesc": "交易成功",    
  "sign": "77bf6dd7da7f6281f1cf2cd64ac91684cebb11d5396ca719fac35f144aa88f11"
}

Response Body Parameters-華南版

Name Type Description
store_id string 華銀所核發之收款方編號
endpointCode string 華銀所核發之端末代號
terminalId string 終端號(機號)
orderNumber string 訂單編號
txnDir string 交易方向(RQ)
txnDateTime string 商店請求日期時間,yyyyMMddHHmmss
txnAmt string 交易金額(含小數兩位),例100->10000
txnCurrency string 交易幣別碼,目前台幣代碼為901
txnSeqno string 銀行端回傳之交易序號
txnAccNO string 付款人帳號後5 碼
respCode string 交易代號,4001:交易成功、9999:處理中、Other:其他資訊
respDesc string 交易資訊

Response-財金版

{
  "mti": "0210",
  "cardNumber": "0006147854124258",
  "processingCode": "012541",
  "amt": "000007434000",
  "systemDateTime": "1007160839",
  "traceNumber": "184845",
  "localTime": "184845",
  "localDate": "20180508",
  "acqBank": "005",
  "srrn": "280160839100",
  "respCode": "4001",
  "terminalId": "00010001",
  "merchantId": "006263015610001",
  "orderNumber": "P201712310000003000",
  "verifyCode": "698408B75204AD6578E3539378BF07217B4ABADEB26FD0E09690B8A4F8BD2291"
}

Response Body Parameters-財金版

Name Type Description
mti string 交易類型
cardNumber string 卡(帳)號,若條碼內含卡(帳)號資訊,則成功交易回應條碼內之卡(帳)號
processingCode string 處理代碼
amt string 交易金額,本欄位含二位小數位,需右靠左補 0
例如:台幣 123 元,其表示為 000000012300
systemDateTime string 系統日期時間
traceNumber string 端末交易序號
localTime string 交易時間(local)
localDate string 交易日期(local)
acqBank string 收單行代碼
srrn string 系統追蹤號
respCode string 回應碼:
  • 4001: 成功
  • 其他: 失敗
terminalId string 端末代號
merchantId string 特店代號
orderNumber string 訂單編號
otherInfo OtherInfo 附加資料 (條件成立才回傳)
verifyCode string 驗證碼

Response Body Parameters - OtherInfo

Name Type Description
tag01 string 收單行資訊
tag02 string 特店負責人員行動電話
tag03 string 特店營業名稱
tag04 string 特店統一編號
tag05 string 端末設備查核碼
tag06 string 繳納期限(截止日)
tag07 string 銷帳編號
tag08 string 被查詢交易之授權回應碼
tag09 string 新驗證參數資訊
tag10 string 新驗證參數檢查值
tag11 string 通知交易之回應碼
tag12 string 端末設備型態
tag13 string 特店交易型態
tag14 string 費用資訊
tag15 string 電子發票手機條碼
tag16 string 行動裝置端使用者IP
tag17 string 互動式附言欄1
tag18 string 互動式附言欄2
tag19 string 互動式附言欄3
tag20 string 付款方識別資訊1
tag21 string 臨櫃銷帳編號
tag22 string 臨櫃繳納期限
tag23 string 臨櫃交易金額
tag24 string 付款方識別資訊2
tag25 string 繳費支付工具類型及手續費
tag26 string 繳費SessionID
tag30 string 轉入行代碼
tag31 string 轉入帳號
tag80 string 端末設備型態代號
tag81 string 掃碼交易補充資訊
tag82 string 結帳日
tag83 string 非促銷商品金額
tag90 string 卡號比對資訊
tag91 string 傳送機構
tag92 string CVC2卡片末三碼
tag97 string QR Code雜湊內容
tag98 string 錢包服務提供者
tag99 string 訊息押碼
tag100 string 加密之卡號
tag101 string QRCode交易卡別
tag102 string Merchant PAN
tag103 string 銀聯QRC Voucher Number
tag104 string 郵遞區號
tag105 string 退貨重送識別碼
tag108 string 付款方電話
tag109 string 付款方電子郵件
tag110 string 付款方英文姓氏
tag111 string TSP Transaction Data
tag112 string PAR
tag113 string MAID
tag114 string PFID
tag115 string Funding Source