下載信用卡撥款對帳資料檔

應用場景

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

  • Step 1. 廠商系統:將要查詢的信用卡撥款資料條件,以POST(HTTP Method)傳送至綠界,進行查詢。
  • Step 2. 綠界:接受信用卡撥款查詢並檢核資料後,回傳CSV檔案格式提供廠商系統下載。

❗ 注意事項:

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

API介接網址

  • 測試環境:因無法提供實際授權,故無法使用此API
  • 正式環境:https://payment.ecPay.com.tw/CreditDetail/FundingReconDetail

HTTPS 傳輸協定

  • Content Type :application/x-www-form-urlencoded
  • HTTP Method :POST

特店傳入參數說明

MerchantID String(10)
特店編號(由綠界提供) 必填 

PayDateType String(10)
查詢日期類別 必填

可依據不同日期類別參數查詢撥款訂單:

  • fund:依交易款項結算日期
  • close:依操作關帳或自動關帳日期
  • enter:依撥款至特店綠界帳戶日期

❗ 注意事項:

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

StartDate 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)
查詢結束日期 必填

要查詢的結束日期
日期格式為「yyyy-MM-dd」

CharSet String(1)
檔案編碼格式 非必填

要下載的檔案編碼格式

  • 若為Big5格式時,則參數請帶1
  • 若為UTF8格式時,則參數請帶2
  • 若未傳入此參數或為空值時,預設為Server Default編碼格式

CheckMacValue String
檢查碼 必填

請參考附錄檢查碼機制

綠界回傳CSV檔案格式說明

序號 String

授權單號 String
授權碼 String
訂單編號 String
交易日期 String

格式為yyyyMMdd

請款日期 String

格式為yyyyMMdd

交易金額 Int

若為退款時,此金額會為負數。

服務費(%數) Int
撥款金額 Int

❗ 注意事項:今日訂單需於隔日的14:00過後方可查到訂單信用卡撥款資訊,信用卡撥款需於銀行工作日時才會進行撥款,假日或非工作日時不會有撥款資訊。

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

綠界官方網站