查詢作業 / 查詢商品資訊

應用場景

提供以商品編號查詢商品狀態、面額等資訊，以確認此商品目前是否可進行票券發行

API介接網址

測試環境：https://ecticket-stage.ecpay.com.tw/api/Ticket/QueryItemInfo
正式環境：https://ecticket.ecpay.com.tw/api/Ticket/QueryItemInfo

HTTPS傳輸協定

Accept：text/html
Content Type：application/json
HTTP Method：POST

特店Request參數說明 (JSON格式)

PlatformID String(10)
平台商或POS商編號

平台商或POS商在綠界的會員編號[MerchantID]

MerchantID String(10)
特店編號 必填

RqHeader Object
傳輸資料 必填

Timestamp Number
傳入時間 必填

請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。

注意事項：

驗證時間區間暫訂為10分鐘內有效，若超過此驗證時間則此次訂單將無法建立，參考資料：http://www.epochconverter.com/。
合作特店須進行主機「時間校正」，避免主機產生時差，延伸API無法正常運作。

Data String
加密資料 必填

回傳相關資料，此為加密過JSON格式的資料。加密方法說明

CheckMacValue String
檢查碼 必填

請參考附錄檢查碼機制進行計算

特店Request參數範例 (Json格式)

				
					{
    "PlatformID": "3002599",
    "MerchantID": "2000132",
    "RqHeader": {
        "Timestamp": 1525168923
    },
    "Data": "…",
    "CheckMacValue": "…"
}

Data參數說明(Json格式)

注意事項：請在加密前對參數值進行 URLEncode

MerchantID String(10)
特店編號 必填

ItemNo String(8)
商品編號 必填

Data參數範例(Json格式)

				
					{
    "MerchantID": "2000132",
    "ItemNo": "CHF80957"
}

綠界Response參數說明 (JSON格式)

PlatformID String(10)
平台商或POS商編號

MerchantID String(10)
特店編號

RpHeader Object
回傳資料

Timestamp Number
回傳時間

時間戳 Unix timestamp

TransCode Int
回傳代碼

1 代表 API 傳輸資料 (PlatformID, MerchantID, RqHeader, Data) 接收成功，實際的API執行結果狀態請參考 RtnCode 參數

TransMsg String(200)
回傳訊息

Data String
加密資料

此參數為加密過的 JSON 格式資料。加密方法說明

CheckMacValue String
檢查碼

請參考附錄檢查碼機制進行計算

綠界Response參數範例 (Json格式)

				
					{
    "PlatformID": "3002599",
    "MerchantID": "2000132",
    "RpHeader": {
        "Timestamp": 1525169058
    },
    "TransCode": 1,
    "TransMsg": "",
    "Data": "…",
    "CheckMacValue": "…"  
}

Data參數說明(Json格式)

RtnCode Int
回應代碼

1為成功，其餘為失敗

RtnMsg String(200)
回應訊息

MerchantID String(10)
特店編號

ItemNo String(8)
商品編號

ItemName String(20)
商品名稱

TicketType String(1)
票券類型

1：提貨券
2：贈品券

ItemAmount Int
商品面額

ItemStatus String(1)
商品狀態

0：已下架
1：上架中

ModifyDate String(14)
最後異動時間

此商品最後一次異動的時間，格式為：yyyymmdd hh:mm

InstructionsList Array[Object]
票券使用說明清單

此為JSON格式字串，包含多筆的票券使用說明資料

IssueType String(1)
出券類型

1：超商票券
2：紙本票券
3：電子票券

Description String(100)
使用說明

依出券類型[IssueType]回傳該類型的票券使用說明事項

Data參數範例(Json格式)

				
					{
    "RtnCode": 1,
    "RtnMsg": "成功",
    "MerchantID":"2000132",
    "ItemNo":"VTMT5062",
    "ItemName":"五星級飯店假日晚餐券",
    "TicketType":"1",
    "ItemAmount":1200,
    "ItemStatus":"1",
    "ModifyDate":"20220801 15:30",
    "InstructionsList":[
        {
            "IssueType":"1",
            "Description":"超商票券使用說明1"
        },
        {
            "IssueType":"1",
            "Description":"超商票券使用說明2"
        },
        {
            "IssueType":"1",
            "Description":"超商票券使用說明3"
        },
        {
            "IssueType":"2",
            "Description":"紙本票券使用說明1"
        },
        {
            "IssueType":"2",
            "Description":"紙本票券使用說明2"
        },
        {
            "IssueType":"3",
            "Description":"電子票券使用說明1"
        },
        {
            "IssueType":"3",
            "Description":"電子票券使用說明2"
        },
        {
            "IssueType":"3",
            "Description":"電子票券使用說明3"
        }
    ]
}

綠界官方網站