瀏覽主題
金流常見串接錯誤與排查建議？ 串接錯誤
- 出現403錯誤多因為 AWS WAF 防火牆對 User-Agent 進行限制，請確保 User-Agent 字串格式正確，如 Chrome 瀏覽器常用格式。
- 請檢查金鑰有效性、網路連線安全規範（TLS1.2）、以及 POST 請求格式與內容的完整性。
- 檢查 PACKAGE_NAME 及 Activity 名稱是否正確。
- 確認傳入參數如交易金額、訂單號、IP、使用者資料完整且格式正確。
- 確認裝置版本及 NFC 或藍牙硬體狀況。
- 注意不同 Action 版本（如 TAP 交易用 ACTION_TAP，退款用 ACTION_TAP_REFUND）。
- 查看回傳碼及訊息，依官方文件對應錯誤類型及解決方案。
金流串接時為什麼出現 403 錯誤？ 串接錯誤
伺服器使用 AWS WAF 防火牆，會阻擋缺乏標準 User-Agent 的請求。請確認 User-Agent headers 設定為類似 Mozilla/5.0 (Windows NT 10.0; Win64; x64) 的正常瀏覽器字串。
常見問題
如何做發票作廢串接？
發票作廢的串接主要是透過「交易退款」API，並以特定欄位 invoice_state 設值為 4 來表示發票作廢（註銷）。特約商店、經銷商兩種模式發票作廢串接的差異主要在 API 位址及驗證身份欄位，整體流程與欄位結構相似： 特約商店發票作廢串接 經銷商發票作廢串接 API 介接網址： 測試區：https://ka.usecase.cc/api/init 正式區：https://ka.mypay.tw/api/init 服務命令：api/refund 主要欄位：…
為什麼使用相機掃描客戶載具，會有缺少字元？
請確認相機完整開啟後，再掃載具條碼，條碼必須在完整框中，才能讀取完整的條碼內容。
如何知道剩下幾張電子發票號碼？
可以透過 MYPAY 交易查詢 API，查詢剩餘可用電子發票號碼數量。實際操作是在呼叫「交易查詢」時，系統回傳結果中會包含 invoice_count 欄位，其值即代表目前專戶剩下的可用電子發票張數。 查詢方式與必備欄位 特約商店（Store 模式）需以交易查詢 API（api/queryorder）發送查詢，必要參數為「uid」（交易流水號）與「key」（驗證碼）。 經銷商（Agent 模式）同樣以交易查詢 API（api/queryorder）查詢，必須帶入「uid」及「key」參數。 回傳資料解析 查詢回傳資料中，invoice_count…
特約商店可用支付工具查詢 API 有哪些？
特約商店可透過「特約商店可用支付工具查詢 API」來查詢目前特約商店所能啟用的支付方式。此查詢主要讓商戶知道可供消費者選擇的付款管道，內容包括信用卡、各電子錢包、ATM 轉帳、超商代碼、虛擬帳號等。 開發者文件(詳細說明及範例碼) 經銷商：https://doc.usecase.cc/Payment/Agent/#d45930806e 特約商店：https://doc.usecase.cc/Payment/Store/#d45930806e 注意事項 依商務代號區別，即可確知貴司身分。 【經銷商】商務代號，尾碼 4 碼 1XXX。 【特約商店】商務代號，尾碼 4 碼…
如何發動發票折讓？
發動發票折讓的方式本質上類似，都是透過「交易退款（api/refund）」API發起折讓請求，但特約商店、經銷商兩模式在使用身分、API介接端點、必要參數等細節上有差異： 發票折讓發動方法（共通點） 折讓由「交易退款 API」發起，帶入折讓相關參數（invoice_state 指定為折讓狀態，退款商品明細 items 須與原發票相符） 送出資料前需以 AES 256 加密，並以 HTTPS POST 送出 發票折讓資料由系統送至財政部電子發票平台完成折讓作業…
高鉅是台灣領先的金融科技公司，專注於提供客製化的金融服務，我們以創新的思維和專業的技術，打造一個安全、便利、高效的支付生態系，搭建起企業、銀行與消費者之間的橋樑，扮演微型商家到大型電商企業最堅實的後盾協助共創三贏。