應用場景
提供廠商下載CSV格式的信用卡撥款對帳檔內容,包含請/退款紀錄的付款資訊。
- Step 1. 廠商系統:將要查詢的信用卡撥款資料條件,以POST(HTTP Method)傳送至綠界,進行查詢。
- Step 2. 綠界:接受信用卡撥款查詢並檢核資料後,回傳CSV檔案格式提供廠商系統下載。
注意事項:
- 此API有限制 IP 存取,請到「廠商後台->系統開發管理->系統介接設定->介接設定」設定 IP 。
- 同IP僅開放一分鐘下載一個對帳資料檔 。
- 請廠商每日進行信用卡撥款對帳查詢,確認撥款資料符合交易付款結果。
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過後方可查到訂單信用卡撥款資訊,信用卡撥款需於銀行工作日時才會進行撥款,假日或非工作日時不會有撥款資訊。