• 開發前請使用 測試區 API (https://ka.usecase.cc/api/init 或 /api/agent) 測試；上線後切換至正式區。
• 建議程式支援 UTF-8 編碼，避免中文商品名稱或地址傳輸亂碼。
• 保留 uid、key、url 三個欄位於交易完成回傳資料，以利後續交易查詢與發票開立使用。
• 若使用 .NET、Java、Python、Node.js 均可參考官方文件範例程式碼結構（含加密模組與 POST 實作）。

需額外發動「代收款核銷撥款請求」 (cmd=api/verify_payment) API，此動作會將交易自動轉入結帳流程並出帳。

若有設定手續費或簡訊費，系統預設自動啟用代收模式；若未帶費用參數或類型，則為一般交易。

若強制指定 is_agent_charge 欄位，會以指定為準。

應使用 /api/agent 介接網址（例如測試區 https://ka.usecase.cc/api/agent），以 agent_uid 身份加密發送金流請求。

所有資料均需經 AES256 加密後再以 Base64 編碼，並使用 application/x-www-form-urlencoded 或 JSON 格式進行 POST。

若使用的 HTTP 函式庫會自動加入 URL Encode，不要再手動重複編碼，否則會產生「解密失敗」錯誤。

若交易回傳延遲超過 5 秒，系統將回應狀態碼 429，表示請求頻率超過限制。建議調整程式重試間隔或減少同時請求量。

伺服器使用 AWS WAF 防火牆，會阻擋缺乏標準 User-Agent 的請求。請確認 User-Agent headers 設定為類似 Mozilla/5.0 (Windows NT 10.0; Win64; x64) 的正常瀏覽器字串。

不能。需透過後台更改，或先取消原定期扣款再以新的卡號重新建立定期扣款資料。

會。預設會於三天之後重新嘗試一次，僅會執行一次自動重扣，可於後台調整設定，但 API 本身不提供修改參數。

不行。若使用電子錢包綁定，只能執行一次性交易，不可同時設置定期扣款。

系統在接到通知時，應立即回傳字串「8888」以確認接收，否則系統會重發通知。

當 MYPAY 接收到上游金流回傳結果後，系統會主動以背景 POST 通知商家系統 URL。

若未收到商家回覆「8888」，MYPAY 會重送通知共 5 次，仍未成功則寄信通知技術窗口人員。

不會。所有交易結果的資料都透過背景通知（Webhook）方式回傳，頁面導轉僅作為視覺導頁用途。

所有交易請求必須從伺服器端發動，不接受來自瀏覽器端的請求，並且僅允許 TLS 1.2 以上版本 HTTPS 連線。

資料傳輸採 AES-256-CBC 加密並以 Base64 編碼封裝。

舊金鑰僅能在未逾期時使用，一旦過期即無法交易。程式必須確保新金鑰替換完成。

MYPAY 會在金鑰到期前 60 天、30 天、20 天寄出提醒，若未處理，於期限前七天自動產出新金鑰並寄出通知信。

金鑰有效期限為一年，可在到期日前七天內（不含第七天）手動延長。

若超過期限系統會自動產生新金鑰，新金鑰會以郵件寄至技術人員信箱。

特約商店可透過「特約商店可用支付工具查詢 API」來查詢目前特約商店所能啟用的支付方式。此查詢主要讓商戶知道可供消費者選擇的付款管道，內容包括信用卡、各電子錢包、ATM 轉帳、超商代碼、虛擬帳號等。

開發者文件(詳細說明及範例碼)

• 經銷商：https://doc.usecase.cc/Payment/Agent/#d45930806e
• 特約商店：https://doc.usecase.cc/Payment/Store/#d45930806e

交易查詢 API 在 MYPAY 金流系統整合支援「特約商店」和「經銷商」雙通路，可用於查詢金流訂單的交易明細與狀態，能完整獲取訂單每一細節狀態與進行後續處理。

開發者文件(詳細說明及範例碼)

• 經銷商：https://doc.usecase.cc/Payment/Agent/#paypage-2
• 特約商店：https://doc.usecase.cc/Payment/Store/#ca077b7e19

1. 請填寫 MYPAY 串接測試環境申請單：https://forms.gle/uGccACeU98DkUFav6
2. 填寫完畢後，請加入官方 LINE: @mypay，與我們聯繫。

實務範例驗證步驟

1. 用 MYPAY 高鉅提供的範例程式做一筆金流訂單測試，取得 response（須為 code:200），並記錄服務端返回訂單 key。​
2. 用本地程式以相同金鑰、IV去解密已加密資料，比對是否還原原始資料內容完全一致。
3. 測試不同語言環境（PHP、C#、Python等），若加解密可互通且 API 都通過則表示加密程序無問題。

請直接回應 8888，即可。

若貴司程式沒有回應 8888，MYPAY系統每間隔 5 分鐘持續 5 次通知。

5 次後還是沒有回應，系統會寄發信件通知貴司/商家的技術人員以及附錄三管理系統額外設定的人員。

當店家想要提供金鑰給委外技術人員時，可上後台到金鑰後方功能區點選重送，利用系統發送致負責的技術窗口。

路徑：系統設定→金鑰管理→點選"重送"

出現重送金鑰的提醒視窗，提醒店家確認發送對象是否正確。

※系統預設發送給基本資料內的技術人員信箱，店家無法另外指定接收信箱。>

該位技術人員將會收到通知信，需使用店家的商務代號解壓縮才能查看。

路徑：系統設定→金鑰管理

金鑰為店家用來對MYPAY發動交易的加密鑰匙，每個店家擁有的金鑰不同，因此該金鑰不得任意外流或是異動，否則將會無法交易。

可以的，請參考開發者技術文件：直接交易 API。

在交易參數中"supplier_code"內指定想要需要的超商代碼。

目前 MYPAY 系統支援 7-11 的 ibon、全家的fimiport、跟萊爾富的hilife，三種超商代碼。

• code：B500
• 訊息：經銷商「289151881001」尚未開通「想就捐慈善勸募系統」串接，如有疑問請洽大特店。
• 說明：此訊息表示該服務未啟用，請檢查串接參數是否正確。

若需 MYPAY 技術支援協助查證，請加入官方 LINE: @mypay，與我們聯繫。