應用場景
提供特店執行查詢訂單交易撥款對帳作業。
API介接網址
- 測試環境: https://ecpayment-stage.ecpay.com.tw/Cashier/ShopifyQueryTradeMedia
- 正式環境: https://ecpayment.ecpay.com.tw/Cashier/ShopifyQueryTradeMedia
HTTPS 傳輸協定
- Content Type：application/json
- HTTP Method：POST
特店Request參數說明 (Json格式)
MerchantID String(20)
特店編號 必填
RqHeader Object
傳輸資料 必填
Timestamp Number
傳輸時間 必填
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
注意事項：
- 驗證時間區間為 10 分鐘內有效，若超過此驗證時間則此次訂單將無法建立，產生時間戳請參考相關資料。
- 合作特店須進行主機「時間校正」，避免主機產生時差，導致API無法正常運作。
Data String
加密資料 必填
此參數為加密過的 JSON 格式資料，加密方式請參考說明。
特店Request參數範例 (Json格式)
{
"MerchantID": "3002607",
"RqHeader": {
"Timestamp": 1234567890
},
"Data": "..."
}
情境一：多筆回傳 (情境一與情境二請擇一使用)
Data參數說明(Json格式) : 請先將Json字串進行urlencode後再進行AES加密
MerchantID String(10)
特店編號 必填
DateType String(1)
查詢日期類別 必填
要查詢的日期類別
- 1 : 查詢結算日期
- 2 : 查詢撥款日期
注意事項：
- 結算日期：交易款項結算至信託專戶的日期，關帳後次一個工作日。
- 撥款入帳日期：結算日期加上您的撥款天期，即為款項撥入您綠界帳戶的日期；若為退刷交易，會先圈存後，於撥款入帳日期實際扣除。
- 此API所使用的查詢條件與查詢的結果會與 綠界廠商管理後台>綠界帳務管理>撥款明細報表>匯出(Shopify專用) 一致(如下圖所示)。
請注意：目前匯出的結果仍含有非Shopify的交易請自行篩選，已安排近期調整優化。
BeginDate String(10)
查詢開始日期 必填
格式為 yyyy-MM-dd
EndDate String(10)
查詢結束日期 必填
調閱區間最大為1個月，格式為 yyyy-MM-dd
PaymentType String(2)
付款方式
欲查詢訂單的付款方式，如未帶此欄位則查詢所有付款方式
- 01 : 信用卡
- 02 : 網路ATM
- 03 : ATM 櫃員機
- 11 : 圓夢彈性分期
Data參數範例(Json格式)
{
"MerchantID": "3002607",
"DateType": "1",
"BeginDate": "2022-01-30",
"EndDate": "2022-01-01",
"PaymentType": "01"
}
情境二：單筆查詢 (情境一與情境二請擇一使用)
Data參數說明(Json格式) : 請先將Json字串進行urlencode後再進行AES加密
MerchantID String(10)
特店編號 必填
PaymentID String(100)
Shopify訂單編號 必填
Data參數範例(Json格式)
{
"MerchantID": "3002607",
"PaymentID": "ASDFrwew234fjpq[93dja';rweiojdds,qwpod01"
}
綠界Response參數說明 (CSV檔案)
廠商訂單編號 String
綠界交易編號 String
PaymentID String
交易日期 String
格式為yyyy/MM/dd HH:mm:ss
付款方式 String
- 信用卡
- 網路ATM
- ATM櫃員機
- 圓夢彈性分期
結算日期 String
格式為yyyy/MM/dd HH:mm:ss
撥款日期 String
格式為yyyy/MM/dd HH:mm:ss
交易金額 Int
手續費 String
回傳資料精確至小數點後3位
手續費率 String
退款金額 Int