應用場景
提供特店執行查詢訂單交易撥款對帳作業。
注意事項：
- 此API有限制IP存取，請到廠商後台->系統開發管理->系統介接設定->介接設定設定IP。
- 僅開放一分鐘下載一個對帳媒體檔。
- 建議每日呼叫「下載特店對帳媒體檔API」 查詢昨日交易訂單結果進行對帳。
API介接網址
- 測試環境: https://ecpayment-stage.ecpay.com.tw/1.0.0/Cashier/QueryTradeMedia
- 正式環境: https://ecpayment.ecpay.com.tw/1.0.0/Cashier/QueryTradeMedia
HTTPS 傳輸協定
- Content Type：application/json
- HTTP Method：POST
特店Request參數說明 (Json格式)
MerchantID String(10)
特店編號 必填
RqHeader Object
傳輸資料 必填
Timestamp Number
傳輸時間 必填
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
注意事項：
- 驗證時間區間為 10 分鐘內有效，若超過此驗證時間則此次訂單將無法建立，產生時間戳請參考相關資料。
- 合作特店須進行主機「時間校正」，避免主機產生時差，導致API無法正常運作。
Data String
加密資料 必填
此參數為加密過的 JSON 格式資料，加密方式請參考說明。
特店Request參數範例 (Json格式)
{
"MerchantID": "3002607",
"RqHeader": {
"Timestamp": 1234567890
},
"Data": "enter your data"
}
Data參數說明(Json格式)
注意事項：請在加密前對參數值進行 URLEncode
MerchantID String(10)
特店編號 必填
DateType String(1)
查詢日期類別 必填
要查詢的日期類別
- 1 : 查詢結算日期
- 2 : 查詢撥款日期
注意事項：
- 結算日期：交易款項結算至信託專戶的日期，關帳後次一個工作日。
- 撥款入帳日期：結算日期加上您的撥款天期，即為款項撥入您綠界帳戶的日期；若為退刷交易，會先圈存後，於撥款入帳日期實際扣除。
BeginDate String(10)
查詢開始日期 必填
格式為 yyyy-MM-dd
EndDate String(10)
查詢結束日期 必填
調閱區間最大為1個月，格式為 yyyy-MM-dd
PaymentType String(2)
付款方式
欲查詢訂單的付款方式，如未帶此欄位則查詢所有付款方式
- 01 : 信用卡
- 02 : 網路ATM
- 03 : ATM 櫃員機
- 04 : 超商代碼
- 05 : 超商條碼
- 11 : 圓夢彈性分期
Data參數範例(Json格式)
{
"MerchantID": "3002607",
"DateType": "1",
"BeginDate": "2022-01-30",
"EndDate": "2022-01-01",
"PaymentType": "01"
}
綠界Response參數說明 (CSV檔案)
特店交易編號 String
綠界交易編號 String
交易日期 String
格式為yyyy/MM/dd HH:mm:ss
付款方式 String
手續費率 String
結算日期 String
格式為yyyy/MM/dd HH:mm:ss
撥款日期 String
格式為yyyy/MM/dd HH:mm:ss
交易金額 Int
金流手續費 Decimal(8,4)
平台手續費 Decimal(8,4)
退款金額 Int
應收款項(淨額) Int