下載檔案 / 下載信用卡撥款對帳檔

應用場景

提供特店下載CSV格式的信用卡撥款對帳檔內容,包含請/退款紀錄的付款資訊。

❗ 注意事項

  • 此API有限制IP存取,請到廠商後台->系統開發管理->系統介接設定->介接設定設定IP。
  • 僅開放一分鐘下載一個信用卡對帳媒體檔。
  • 建議每日進行信用卡撥款對帳查詢,確認撥款資料符合交易付款結果。

API介接網址

  • 測試環境: 因無法提供實際授權,故無法使用此API
  • 正式環境: https://ecpayment.ecpay.com.tw/1.0.0/Cashier/QueryCreditTradeMedia

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 : 查詢撥款日期
  • 3 : 查詢關帳日期

❗ 注意事項:

  • 結算日期:交易款項結算至信託專戶的日期,關帳後次一個工作日。
  • 撥款入帳日期:結算日期加上您的撥款天期,即為款項撥入您綠界帳戶的日期;若為退刷交易,會先圈存後,於撥款入帳日期實際扣除。
  • 關帳日期:後台操作關帳或系統自動關帳執行日期,綠界系統將於關帳後向銀行請款。

BeginDate String(10)
查詢開始日期 必填

格式為 yyyy-MM-dd

❗ 注意事項:搜尋日期必須為銀行上班日的14:00之後才能查到資料。
Ex: 1/16、1/17為銀行休假日,1/18的14:00之後才能查到1/15~1/17的資料;搜尋日期必須是1/18

EndDate String(10)
查詢結束日期 必填

調閱區間最大為1個月,格式為 yyyy-MM-dd

Data參數範例(Json格式)

				
					{
    "MerchantID": "3002607",
    "DateType": "1",
    "BeginDate": "2022-01-30",
    "EndDate": "2022-01-01"
} 

				
			

綠界Response參數說明 (CSV檔案)

授權單號

授權碼 

關帳單號 

廠商自定義欄位 

廠商自定義欄位

此欄位資料為,執行退款時,帶入之廠商自定義欄位。

綠界訂單編號

交易日期

格式為yyyyMMdd

請款日期 

格式為yyyyMMdd

交易類型 

發卡銀行 

卡號

顯示前六後四的卡號,中間資料隱碼。

Ex: 123456xxxxxx1234

交易金額 

手續費

手續費率

處理費 

服務費

撥款金額

撥款入帳日期

格式為yyyyMMdd

結算日期

格式為yyyyMMdd

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

綠界官方網站