下載檔案 / 下載撥款對帳檔

應用場景

提供特店執行查詢訂單交易撥款對帳作業。

❗ 注意事項

  • 此API有限制IP存取,請到廠商後台->系統開發管理->系統介接設定->介接設定設定IP。
  • 僅開放一分鐘下載一個對帳媒體檔。
  • 建議每日呼叫「下載撥款對帳檔」 查詢昨日交易訂單結果進行對帳。

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

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.

綠界官方網站