查詢訂單 / 查詢信用卡單筆明細

應用場景

提供特店查詢訂單信用卡單筆明細記錄。
❗ 注意事項:
  • 取得付款結果通知時,請呼叫查詢訂單API驗證付款結果
  • 假如程式呼叫 API 的速度太快,會收到 HTTP Status Code 403 的狀態碼,此時請降低呼叫 API 的速度,並等候 30 分鐘後再重新呼叫,如果有高速存取 API 的需求,請先確認您具備「特約賣家」身分,並聯繫所屬業務人員。

API介接網址

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

HTTPS 傳輸協定

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

特店傳入參數說明

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

CreditRefundId Int
信用卡授權單號 必填 

建立訂單時,將參數[NeedExtraPaidInfo]設定為 Y,即可透過付款結果通知取得此參數(CreditRefundId=gwsr)資料。

CreditAmount Int 
金額 必填 

CreditCheckCode Int 
商家檢查碼 必填 

廠商後台->信用卡收單->信用卡授權資訊中可查到。

CheckMacValue String 
檢查碼 必填 

將收到的參數和參數值,加上特店的HashKey&HashIV所產生,請參考附錄檢查碼機制

❗ 注意事項:
  • 若未收到付款結果通知時,您可以使用特店交易編號(MerchantTradeNo)呼叫站內付信用卡明細查詢API,來查詢信用卡授權結果。

綠界回傳參數說明

RtnMsg String(200)
回應訊息

  • 若成功回傳空值其餘則為失敗
  • 若查無商家或商家己到期,回傳值為: error_Stop
  • 若查無該筆交易授權單號時,回傳值為: error_nopay
  • 若發生錯誤或資料檢核失敗,則回傳值為: error

RtnValue json
回應內容

若回傳空值則為查詢失敗

TradeID Int
授權單號

amount Int
交易金額

clsamt Int
已關帳金額

authtime String(24)
訂單成立時間

status String(30)
交易狀態

若未有關帳明細交易,狀態回傳值如下:

  • 已取消:此筆交易已取消
  • 未授權:銀行未授權完成
  • 已授權:銀行已完成授權

若已有關帳明細交易,狀態回傳值如下:

  • 已關帳:此筆交易已完成關帳
  • 已取消:此筆交易已取消
  • 操作取消:此筆交易已取消關帳

close_data json
關帳明細

內容請參考關帳明細參數說

close_data json
關帳明細

status String(30)
狀態

狀態回傳值如下:

  • 要關帳
  • 已關帳
  • 已取消
  • 操作取消

amount Int
交易金額

sno String(30)
關帳序號

datetime String(24)
關帳時間

綠界回傳參數範例

				
					{
 "RtnMsg":"",
     "RtnValue":{
      "TradeID":"0015625112",
      "amount":"1",
      "clsamt":"1",
      "authtime":"2016/5/12 下午 07:09:17",
      "status":"已關帳",
      "close_data":[
       {
       "status":"已關帳",
       "sno":"2782343",
       "amount":"1",
       "datetime":"2016/5/12 下午 08:00:00"
       }
      ]
     }
 }

				
			

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

綠界官方網站