應用場景
提供特店下載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