全方位金流API技術文件 / 常見技術FAQ

常見付款狀態未更新原因

若消費者已經付款,綠界廠商管理後台也已更新付款

但您的系統後台(Woocommerec、Opencart、QDM、美安….平台)

付款狀態未被更新,請程式人員檢查以下設定:

(1)接收付款通知的伺服器是否異常

● 如您正在舉辦搶購活動,請務必確保伺服器可短時間大量接收綠界回傳的付款結果通知

   Ex:AWS、台灣固網….等其他網路業者,預設防火牆機制,短期間接收大量回傳會視為攻擊事件

(2)近期是否有變更接收付款通知的ReturnURL網址

(3)接收付款結果的ReturnURL程式是否有判斷交易成功(RtnCode=1表示付款成功,其餘代碼為失敗)

(4)貴司系統收到綠界回傳結果,是否有正確回應1|OK

(5)因資安政策規定綠界僅提供443 PORT且需使用合法的DomainName進行設定

上述原因確認完畢,仍然無法排除此問題請提供以下資訊

並Email至techsupport@ecpay.com.tw

(1)商店代號(MerchantID)

(2)廠商交易編號(MerchantTradeNo)

(3)交易日期(MerchantTradeDate)

為什麼Key完卡號送出以後一片空白?

1.在ECPAY輸入完卡號送出後會將頁面導向各銀行進行3D驗證,

如您使用的瀏覽裝置版本不符合銀行規範(請自行參考各銀行規範),將可能未知出現錯誤

建議更新瀏覽器版本或更換裝置重新下單購買。

2.若是使用webview方式與Ecpay串接,請注意以下事項

UserAgent 設定:若有指定版本可能會造成在銀行端進行3D驗證時出現以下畫面

因安全性考量如必須要指定版本,建議定期更新,避免無法進行3D驗證而損失訂單。

ItemName使用注意事項

ItemName容易因為瀏覽器編碼問題,  導致送過來的品名會變成亂碼

可能會產生以下幾種錯誤

1.跳至綠界首頁

2.空白畫面

3.檢查碼錯誤…等。

此參數有400字元的限制,超過便會被截斷,截斷處容易產生亂碼,進一步導致檢查碼錯誤,

因此建議請固定設定『XX商城商品一批X1』的固定字樣,

如此便可避免遇到上述狀況導致掉單。 並請於您的網站顯示完整的商品明細即可。

如何不經過綠界畫面取得ATM、CVS、BARCODE的繳費代碼

可以透過綠界「非信用卡幕後取號API」,直接於後端取得所需的ATM、CVS、BARCODE繳費代碼。

文件請參考: https://developers.ecpay.com.tw/?p=27950

交易失敗: MerchantID is Null

若出現MerchantID is Null 畫面,請確認以下原因

  • POST方式:是否為Form表單送出

原因是Ecpay僅接受Form表單格式,如格式錯誤將視為沒有帶參數值。

  • Form表單屬性是否使用了blank

原因是消費者使用IOS行動裝置中的 Facebook 、LINE等APP 直接開啟您的商店連結進行結帳,因為APP無法接受開新分頁或另開視窗以致表單資料無法POST給綠界故無法完成交易。若您的系統設計是使用開新分頁或另開視窗,建議您將Form 表單的屬性 target=”_blank”移除或提示消費者將您的商店連結複製到手機瀏覽器上進行交易。 

交易失敗: 付款失敗-10100058 Pay fail.

當您在綠界金流付款頁面輸入卡號送出後,系統將引導至各發卡行進行3D驗證。若輸入之卡號等資訊皆輸入正確,但出現以下畫面時,處理方式建議如下:

  • 請更換瀏覽器裝置後重新下單 (例如更換手機、PC)
  • 若有使用VPN請暫時關閉並重新下單

 

❗ 若仍遇到錯誤畫面,可能原因:

  • 使用的瀏覽器版本不符合銀行規範,建議更新瀏覽器版本。
  • 目前使用的IP位置不符合銀行資安規範,請參考以下方式更換IP位址。
    • 飛航模式切換:等待片刻(通常30秒左右),然後關閉飛航模式。
    • 重新啟動手機:重開機後,有可能獲得新的IP位址。
    • 更換網路連接:切換到不同的Wi-Fi網絡,或者關閉Wi-Fi並使用行動數據連接。
  • 交易方式為定期定額時,如付款頁所填寫的手機號碼與銀行資料不一致,則會交易失敗。

信用卡已付款官網卻沒有更新狀態?

若您的伺服器有問題或其他因素導致無法接收到付款結果

(API串接有正確設置 ReturnURL) 

Ecpay將主動再次通知,時間為5~15分鐘1次,共發送4次。

若還是未能收到,可參考以下方式進行作業及反查

1.建議您至廠商管理後台進行相關操作以利您的出貨及對帳作業。

頁面路徑:廠商管理後台(可點擊另開)→信用卡收單→交易明細查詢

●輸入授權單號,開始搜尋。您會看到表格的第一欄如下圖所示:

●點選表格內藍色有底線之「授權單號」,即可見「授權回傳(補觸發)」按鈕。點擊以進行補授權作業。

2.未出現補授權按鈕建議–呼叫查詢信用卡單筆明細記錄API

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

綠界官方網站