Skip to content

Taiwan Pay Search

Description

Taiwan Pay查詢訂單。

Resource

GET /v1/payment/taiwan/{order_id}

Authorization

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

Path Parameters

Name Type Description
order_id string 訂單編號

Query Parameters

Name Type Description
shop_id string 分店編號

Request

GET /v1/payment/taiwan/pay/00003021091100011?shop_id=000030

Response-華南版

{
    "txnDir": "RS",
    "orderNumber": "00003021091100011",
    "txnRefundAmt": "",
    "txnRefundSeqno": "",
    "txnCurrency": "901",
    "sign": "40d76d72a077100c35465193a93905ce4e90781cc741a5cd7a6e36508925272b",
    "txnType": "2541",
    "terminalId": "k1",
    "carrierId1": "/UPP2YM2",
    "carrierId2": "",
    "txnDateTime": "20210911153010",
    "txnAccNO": "41119",
    "inqTxDate": "",
    "cardAuthCode": "",
    "inqDateTime": "20210911",
    "respDesc": "交易成功",
    "endpointCode": "00000001",
    "carrierType": "",
    "storeId": "008244360740001",
    "storeMemo": "",
    "txnAcctDate": "20210913",
    "txnSeqno": "20210911153010224426",
    "crtDateTime": "20210911153010",
    "txnAmt": "2000",
    "respCode": "4001"
}

Response Body Parameters-華南版

Name Type Description
txnDir string 交易方向(RQ：Request 店家端填入 RS：Response 銀行端填入)
orderNumber string 訂單編號
txnRefundAmt string 已退款金額
txnRefundSeqno string 店家部份退款序號/金額
sign string 店家端與銀行端 Mac 驗證值
txnType string 交易類型 (2541:付款 2542,2543:退款)
terminalId string 終端號(機號)
carrierId1 string 載具顯碼 id
carrierId2 string 載具隱碼 id
txnDateTime string 商店請求日期時間，yyyyMMddHHmmss
txnAccNO string 付款人帳號後5 碼
inqTxDate string 查詢日期
cardAuthCode string 信用卡授權碼
inqDateTime string 發動日期(發動訊息查詢/回復時間)
respDesc string 交易資訊
endpointCode string 華銀所核發之端末代號
carrierType string 載具類別號碼
storeId string 華銀所核發之收款方編號
storeMemo string 店家端保留欄
txnAcctDate string 帳務日期
txnSeqno string 銀行端回傳之交易序號
crtDateTime string 建立日期時間
txnAmt string 交易金額(含小數兩位)，例100->10000
respCode string 交易代號，4001：交易成功、9999：處理中、Other:其他資訊

Response-財金版

{
    "mti": "0810",
    "cardNumber": "0006147854124258",
    "processingCode": "000170",
    "systemDateTime": "0508190018",
    "traceNumber": "190018",
    "srrn": "128190018440",
    "respCode": "4001",
    "terminalId": "00010001",
    "merchantId": "006263015610001",
    "otherInfo": {
        "tag08": "0000"
    },
    "verifyCode": "4B58E25D96A522220579F874DB51FCD88B54C0123338E231A72F41007164A319",
    "orgTxnData": {
        "tag04": "0508190014",
        "tag08": "943003103933"
    }
}

Response Body Parameters-財金版

Name Type Description
mti string 交易類型，訂單查詢交易 API 為 0810
cardNumber string 卡(帳)號
processingCode string 處理代碼，訂單查詢交易 API 為 000173
systemDateTime string 系統日期時間
traceNumber string 端末交易序號
srrn string 系統追蹤號
respCode string 回應碼:
  • 4001: 成功
  • 其他: 失敗
txnType string 跟華南版相同
terminalId string 端末代號
merchantId string 特店代號
orderNumber string 訂單編號
otherInfo OtherInfo 附加資料
verifyCode string 驗證碼，本欄位依電文交易內容『系統參數名稱』由小到大排序，最後加入驗證參數值，透過SHA-256方式產出驗證碼。其中，驗證碼與空值(null)則不予採納計算。驗證參數需事前於雙方系統內設定。
orgTxnData OrgTxnData 原始交易資訊

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

Response Body Parameters - OrgTxnData

Name Type Description
tag01 string 原交易類型
tag02 string 原處理代碼，原交易若為QRCode掃碼購物交易需比照消費扣款購物(變動費率)交易放置002541，目前限定查詢002541、002542、002543
tag03 string 原交易金額
tag04 string 原系統日期時間
tag05 string 原端末交易序號
tag06 string 原交易時間
tag07 string 原交易日期
tag08 string 原系統追蹤號
tag10 string 訂單狀態:
  • 3: 取消訂單
  • 8: 已退貨
  • 9: 授權成功
  • X: 失敗
tag11 string 累積退貨金額