非信用卡支付可使用共同支援的 ACTION_SEND_TRANSACTION，搭配不同的 PAY_MODE_ID，如 LINE PAY 等。

• 必須保證 MYPAY App 在前台，系統才允許此串接模式使用。

串接MYPAY金流系統後，運作流程為消費者於商店結帳畫面輸入行動支付帳號、手機號等資訊，商店端主動由 POS 或前後台掃描消費者螢幕產生的條碼。

若 POS 系統無法掃碼或付款失敗：

1. 錯誤排查：應檢查條碼類型、API 參數回傳訊息及支付工具端設定，最常見錯誤為「條碼編碼不合規」或「支付工具尚未綁定」。
2. 流程注意事項：商店端串接需正確取得消費者條碼資料串並呼叫 API 送出，部分工具須校驗條碼格式或限制掃描次數。

請參閱技術文件，詳細檢查開發者設定：

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

串接MYPAY金流系統後，運作流程為消費者主動打開行動支付App掃描商店端QRCode，平台需顯示動態碼或靜態碼供消費者掃描。

若消費者掃碼無法付款：

1. 錯誤排查：追查 QRCode 生成格式、是否與支付工具規範一致、或串接API參數是否正確填寫。
2. 流程注意事項：商店端需確保 QRCode 有效且支付工具支援動態/靜態碼呈現，部分工具更新後會要求特定格式。

請參閱技術文件，詳細檢查開發者設定：

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

• 行動支付付款成功後可於有效期限內發動退款或作廢 API。
• 注意部分支付工具退款須於指定時限內發動，否則無法再退；API發動時需查詢當次交易工具及條件。

• 檢查 user_id、user_cellphone、商店支付工具是否正確；依支付工具規範比對欄位格式。
• 檢查是否有國碼格式錯誤、消費者手機未綁定該支付工具。

• 行動支付類型不支援經銷商代收費模式，若交易指定為代收費則自動降為一般模式。
• 超商、第三方支付如掃碼付款通常有時間性限制與金額上限，需依支付工具規範設計。

• 部分支付方式（如電子錢包 Barcode 掃描）會額外要求 user_name、user_real_name、user_cellphone_code、user_cellphone 等欄位。
• 預設需提供消費者行動造碼（國碼及手機號）及載具資訊。

• 可用 API 查詢特約商店可支援之支付工具組合。
• 若欲限定某交易只能用特定支付工具，可於串接參數 pfn 傳入對應代碼。

• 支援多種支付工具，如 LINE Pay、Apple Pay、Google Pay、街口支付、Pi 錢包等。
• 串接時可選用預設支付方式（pfn）或由消費者端介面自由選擇。

電子發票主要 API 參數參考：

* 電子發票串接的相關更新，請以技術文件為準：

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

• Cross App 模式：使用 Intent 互動，最常見。
• 裝置外部有藍牙模式與網路串接刷卡機模式，Android 10 以後需 App 在前台才能使用網路串接。

• 使用 ACTION_CREATE_INVOICE 建構交易完成後的發票資料進行開立。

• 交易請求與回應皆透過 MyPayCommon 的 ActionDetails 類別，請求時以 JSON 字串設定 data 欄位。
• 回應資料透過 Intent 回傳，回傳時仍為 ActionDetails，data 欄位包含結果 JSON。

• 可使用 ACTION_PRINT 動作列印發票、明細、簽單，純列印不會產生交易。

• 商米設備包含 V2s、V3、V3 MIX、D3 MINI 等，非列表內設備不保證成功串接。
• iMin 設備僅 Swift 2 Pro 有保證支援。

MYPAY App 查詢交易與退款：

• 查詢交易使用 ACTION_QUERY_TRANSACTION。
• 退款使用 ACTION_REFUND，並可設置作廢發票狀態。

透過 Intent 設定 PACKAGE_NAME 為 tw.com.mypay.tap.dev（測試）或 tw.com.mypay.tap（正式）和 Activity 名稱 tw.com.mypay.MainActivity。

設置 MYPAY App 的支付方式：

• 付款方式以 PAY_MODE_ID 標示，如信用卡、Line Pay、街口支付等。
• 產生 QR Code 交易使用 ACTION_SEND_TRANSACTION 並設置相應支付方式。

• 開發前請使用 測試區 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 天寄出提醒，若未處理，於期限前七天自動產出新金鑰並寄出通知信。

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

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

檢查 invoice_xxx 相關欄位是否正確填寫、資料型態、編碼（UTF-8），出現錯誤建議查閱 API 回覆與管理後台日誌以快速定位問題。

• ACTION_TAP_INIT 可在信用卡交易或退款之前呼叫，用於提前初始化，減少交易時等待的時間。
• 雖非強制使用，但建議預先呼叫以提升使用體驗。

• 透過 Intent 傳送 ActionDetails 物件，並設置指定的 Action（如 ACTION_SEND_TRANSACTION）。
• 傳入包含交易信息的 JSON 字串。
• 在 onActivityResult 中取得回傳資料。

選擇實體/B2B發票類型時，部分欄位如抬頭、統編、地址等受限制（不可手動異動），須依管理端設定。

• Tap 不支援 ACTION_SEND_TRANSACTION 裡的 PAY_MODE_ID_CREDIT_CARD，必須使用 ACTION_TAP Action 來進行信用卡交易。
• 退款操作同樣必須使用 ACTION_TAP_REFUND。

使用不同的包名（PACKAGE_NAME）：

• MYPAY App 測試︰cc.usecase.mypay
• MYPAY App 正式︰tw.com.mypay
• MYPAY Tap 測試︰tw.com.mypay.tap.dev
• MYPAY Tap 正式︰tw.com.mypay.tap

有，test/stage API 回傳 invoice_count 為剩餘張數，開立前建議查詢（特殊情境如預印存量警示）。

• MYPAY Tap 要求 Android 9 以上，且必須支援 Google Mobile Services(GMS) 與 NFC，非 EMV 設備。
• Tap 專為 NFC 感應信用卡交易設計，支持特定硬體，如：商米V2s、V3 等。
• Tap 的 PACKAGE_NAME 與測試、正式環境區分明確，如：正式環境為 tw.com.mypay.tap。

• 將最新版 AAR 檔（MyPayCommon_vX.X.X_release.aar）放入 app/libs 資料夾。
• 在 build.gradle 中增加依賴，並在 release 版本須添加 ProGuard 保護設定。

「1」代表雲端發票（載具儲存於雲端），「2」愛心碼（捐贈發票）、「3」B2B（公司/行號發票），必填欄位根據類型不同而異。

在 MYPAY Tap 環境下發動退款（信用卡 Tap 交易的退款），需使用專用的 ACTION_TAP_REFUND 動作。

參數設定重點

• action 值：Constant.ACTION_TAP_REFUND
• data：放入AppRequest的JSON 字串，須包含退款資料。
• PACKAGE_NAME：根據測試環境或正是環境設定。
• TARGET_ACTIVITY_NAME：固定為 tw.com.mypay.MainActivity。

注意事項

• 必須使用 Tap 專用的退款 Action (ACTION_TAP_REFUND)，不可再使用 ACTION_REFUND。
• 若先呼叫 ACTION_TAP_INIT 可預初始化裝置，縮短退款時等待時間。
• 須確保 Android 版本需在 9 以上且裝置支援 GMS 與 NFC。

• MYPAY App：支援 Android 7 以上，為 EMV 設備，GMS 與 NFC 非必要。
• MYPAY Tap：需 Android 9 以上，支援 NFC 與 GMS，非 EMV 設備，專為信用卡感應支付設計。
• MYPAY App 和 MYPAY Tap 兩者的支援設備與串接包名不同。

可以！MYPAY 提供獨立的發票查詢 API（api/queryinvoice），參數需包含訂單 uid、key 或發票號碼進行查詢。

退款時可同時指定 invoice_state 欄位（如 6 標示已折讓），在 API 內一併處理退貨折讓發票問題。