Integrate JKO QRCode Pay Cancel
Description
JKO Pay 條碼支付取消交易。
JKO Pay 金流參數：特店代碼、特店密鑰、商店編號
情境：
- 依廠商金流參數設定進行付款：金流參數為必填、門市代碼不需要填
- 依全通路金流參數設定進行付款：門市代碼為必填、金流參數不需要填
Resource
POST /v1/payment/integrate/cancel
Authorization
採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。
Request Body Parameters
| Name | Type | Description |
|---|---|---|
| type | string | 付款方式，請輸入 JKO_QRCODE_PAY |
| request | Request | 請求參數 |
| store_id | string | 門市代碼 (optional) |
| is_test | boolean | 是否為測試環境
|
Request Body Parameters - Request
| Name | Type | Description |
|---|---|---|
| MerchantID | string | 特店代碼 (optional) |
| MerchantKey | string | 特店密鑰 (optional) |
| StoreID | string | 商店編號 (optional) |
| StoreName | string | 商店名稱 |
| GatewayTradeNo | string | 銀行端交易序號(需與付款相同) (optional) |
| MerchantTradeNo | string | 商店端交易序號(付款流水號)(需與付款相同) |
| PosID | string | POS 機號 |
| PosTradeTime | string | POS 端交易日期時間 格式：yyyy/MM/dd HH:mm:ss |
| CardToken | string | 支付條碼(需與付款相同) |
| TradeAmount | integer | 實際消費金額(需與付款相同) |
| UnRedeem | integer | 不可折抵金額(需與付款相同) |
| Remark | string | 備註 (optional) |
| Extra1 | string | 保留欄位一 (optional) |
| Extra2 | string | 保留欄位二 (optional) |
| Extra3 | string | 保留欄位三 (optional) |
| SendTime | string | 交易發送日期時間 格式：yyyyMMddHHmmss |
Request
{
"type": "JKO_QRCODE_PAY",
"request": {
"MerchantID": "9999999",
"MerchantKey": "2AA6B9B6F9C64247ABB2677B6AF2C896",
"StoreID": "9999999",
"StoreName": "街口測試",
"GatewayTradeNo": "",
"MerchantTradeNo": "2020009041651",
"PosID": "1",
"PosTradeTime": "2020/08/01 10:05:11",
"CardToken": "22J111111111111111",
"TradeAmount": 0,
"UnRedeem": 0,
"Remark": "",
"Extra1": "",
"Extra2": "",
"Extra3": "",
"SendTime": "202008011005"
},
"store_id": "0",
"is_test": false
}
Response Body Parameters
| Name | Type | Description |
|---|---|---|
| MerchantID | string | 特店代碼 |
| StoreID | string | 商店編號 |
| GatewayTradeNo | string | 銀行端交易序號 (optional) |
| MerchantTradeNo | string | 商店端交易序號(付款流水號) |
| PosID | string | POS 機號 |
| TradeAmount | integer | 實際消費金額 |
| StatusCode | Status Code | 回應碼，000為成功 |
| StatusDesc | string | 回應碼說明 |
| ActionCode | string | 建議處理代碼 保留欄位 |
Response
{
"MerchantID": "9999999",
"StoreID": "9999999",
"MerchantTradeNo": "2020009041651",
"PosID": "1",
"TradeAmount": 0,
"StatusCode": "000",
"StatusDesc": "交易成功",
"ActionCode": "0"
}
Response Body Parameters - Status Code
| Status Code | Description |
|---|---|
| 000 | 交易成功 |
| 801 | JKOS-Gateway 失敗 - Gateway 連線異常 |
| 802 | JKOS-Gateway 失敗 - 交易失敗{errCode} {errCode}：為銀行回傳之失敗代碼 |
| 811 | 與原交易參數不符，無法查詢 |
| 901 | 未明確定義錯誤 |
| 902 | 來源 IP 不被允許 |
| 903 | 加解密失敗 |
| 904 | 加簽或驗簽失敗 |
| 905 | 解析資料失敗 |
| 906 | 條碼已失效 |
| 907 | 非街口合作店鋪 |
| 908 | 特店資料無法交易 |
| 909 | 寫入資料失敗 |
| 910 | 時間戳章驗證失敗 |
| 911 | 金流介接失敗 |
| 912 | 查無會員 |
| 913 | 請消費者重新登入或確認手機為正確時間之後再嘗試 |
| 914 | 條碼已使用，請重新產生 |
| 915 | 不支援街口支付功能 |
| 916 | 查無此訂單 |
| 917 | 退款失敗，電子支付可提領餘額不足 |
| 918 | 退款失敗，支付金額為 0 元，不可退款 |
| 919 | JKOS 交易失敗 |
| 920 | 特店交易無法使用該發卡行信用卡 |
| 921 | 信用卡尚未通過驗證流程，此交易已超過額度上限 |
| 922 | 922 退款總金額已超過原付款交易金額[含多次退款] |
| 923 | 退款失敗，街口幣餘額不足無法退款 |
| 924 | 信用卡尚未通過驗證流程 |
| 925 | 請確認是否重複退款 |
| 926 | 資料格式不符合 Json Format |
| 927 | 條碼錯誤 |
| 928 | 消費者街口帳戶餘額不足 |
| 929 | 不支援此支付方式 |
| 931 | 交易金額已達限額 |
| 932 | 店家收款金額已達限額 |
| 934 | 訂單狀態異常，無法退款 |
| 935 | 交易金額已達每日店鋪限額 |
| 939 | 學生儲值卡餘額不足 |
| 940 | 支付金額不可小於等於 0 元 |
| 941 | 用戶未確認交易或取消交易 |
| 951 | 退款造成街口帳戶支出，故拒絕退款 |
| 961 | 退款金額需收回街口幣或現金回饋，造成信用卡退刷金額異常 |
| 962 | 退款失敗，儲值卡退款失敗 |
| 968 | 此筆交易有使用街口券，無法部份退款 |
| 975 | 退款金額大於店家累計未請款金額，故退款失敗 |
| 977 | 目前此用戶無法使用街口服務，如需啟用可洽街口客服 02-87717212 (977) |
| 978 | 用戶已銷戶，無法使用街口服務，如有疑問可洽街口客服 02-87717212 (978) |
| 980 | 交易失敗，該店鋪已下線 |