單筆交易查詢

SingleOrderQuery

說明

單筆交易查詢

若使用單筆交易作為交易結果輪詢(polling), 請兩秒鐘呼叫一次此API. (同一個特店帳號, 若短時間內有過多的交易查詢, 會使系統將其IP位址鎖定不允許呼叫API)

Request

欄位

必填

型別

範例

說明

Method

YES

String(5)

00000

請填入固定值00000

ServiceType

YES

String(32)

SingleOrderQuery

所選用的Scan2Pay服務代碼

MchId

YES

String(32)

Account0001

由intella所提供的特店帳號

TradeKey

YES

String(128)

sha256...hash

由intella所提供的交易密碼, 此密碼須先經過SHA256編碼後再填入

CreateTime

YES

String(14)

20180101120000

Request建立時間, 格式為yyyyMMddHHmmss

Data

欄位

必填

型別

範例

說明

StoreOrderNo

YES

String(20)

PO180101001

所要查詢的訂單編號

Response

Header

欄位

型別

範例

說明

StatusCode

String(4)

0000

交易結果代碼

StatusDesc

String

交易成功

交易結果代碼說明

Method

String(5)

10100

支付平台代碼

ServiceType

String

SingleOrderQuery

所選用的Scan2Pay服務代碼

MchId

String

Account0001

特店帳號

ResponseTime

String

20180101120000

交易回應時間, 格式為yyyyMMddHHmmss

Data

欄位

型別

範例

說明

SysOrderNo

String

2018010110074205610

系統訂單編號

StoreOrderNo

String

PO180101001

特店訂單編號

TotalFee

String

90

訂單交易金額

Body

String

雞排

商品描述

OrderStatus

String

1

訂單狀態 (0: 處理中 / 1: 交易成功 / 2:失敗 / 3: 退款)

PaidAt

String

20180101100755

與支付方的交易日期/時間

RefundedMsg

String

Refund success

OrderStatus為3(退款)時, 會帶有此欄位, 此欄位會顯示退款狀態訊息 (退款成功: Refund success, 退款失敗: Refund fail)

API Example

Request

{
"Header": {
"Method": "00000",
"ServiceType": "SingleOrderQuery",
"MchId": "myMchId",
"TradeKey": "9af15b336e6a9619928537df30b2e6a2376569fcf9d7e773eccede65606529a0",
"CreateTime": "20180715102627"
},
"Data": "{\"StoreOrderNo\":\"PO-20180715-001\"}"
}

Response

{
"Header": {
"StatusCode": "0000",
"StatusDesc": "執行成功",
"Method": "11500",
"ServiceType": "SingleOrderQuery",
"MchId": "myMchId",
"ResponseTime": "20180715102629"
},
"Data": {
"SysOrderNo": "2018071544571196210",
"StoreOrderNo": "PO-20180715-001",
"TotalFee": "90",
"PaidAt": "20180101100755",
"Body": "Chicken Rice-6485",
"OrderStatus": "1"
}
}