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 | 回應碼:
|
| 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 |