2026-08-24
如果你已經照著教學把 Portaly Payment 串進自己的產品,卻發現用戶付款一直沒反應,很可能是還卡在 Test 模式,或是金流驗證根本還沒過。這篇會用一張清單,把 Test/Live 模式差在哪、驗證流程要花多久、卡關時怎麼自救,一次講清楚。
金流驗證是人工審核,通常要 7-15 個工作天(不含例假日)。如果你是頂級方案會員,而且已經綁定信用卡,可以享有優先審核。
送審前,先對照這 3 項,能大幅降低被退件的機率:
實務上最常見的退件原因,是系統顯示「頁面內容或商品項目不完整」,意思是審核團隊覺得你的頁面看起來還沒有「真的在營業」。把上面 3 點都補齊,重新送審就好,不需要整個流程重跑。
很多人第一次卡關,其實不是程式碼寫錯,而是分不清楚自己現在是不是在「玩假的」。Portaly Payment 用 API Key 的開頭直接區分兩種模式:

| 模式 | Key 開頭 | 會發生什麼事 | 適合階段 |
|---|---|---|---|
| Test 模式 | pcs_test_... | 不會真的扣款,可以用來跑完整個串接流程 | 開發、測試 |
| Live 模式 | pcs_live_... | 觸發真實付款,用戶的卡會被真的刷 | 正式上線 |
這裡有個關鍵,很多人會忽略:金流審核沒有通過之前,你的後台只會給你 Test API Key,Live Key 根本申請不到。 也就是說,就算程式碼寫得再完美,只要驗證還沒過,用戶就是不可能付款成功。
切換到正式收款的動作其實很簡單:回到 Portaly Payment 後台建立一組 Live 模式的 Key,換掉 .env 裡的值就好,方案、程式碼都不用重新弄。
另外提醒一件事:API Key 跟 Callback Secret 是配對出現的,之後如果忘記存值要重建,記得兩個一起換,不能只換其中一個,不然驗證會對不上。

把這份清單存下來,正式上線前照著勾一次:

只要這幾項都打勾,理論上就不會再遇到「用戶付款卻沒反應」的狀況。
驗證過關、開始收款只是第一步,很多人接著會問「錢什麼時候會到我的戶頭」。Portaly 採用月結提領制:
| 項目 | 說明 |
|---|---|
| 結算週期 | 每月 15 日結算上個月的款項 |
| 申請提領時間 | 每月 15-20 日開放申請(遇假日順延) |
| 撥款時間 | 每月 25-30 日完成撥款 |
費用結構上,基本方案沒有月費、交易抽 12%;如果交易量比較大,可以升級頂級方案,抽成降到 6%,長期用下來通常更划算。
Q:API Key 忘記存起來,找不到原本的值怎麼辦?
回後台重新建立一組新的就好,但記得 API Key 跟 Callback Secret 要一起換,不能只換一個。
Q:金流驗證一直卡在審核中,正常嗎?
7-15 個工作天內都算正常範圍。如果超過這個時間還沒結果,且確認自己已經完成頁面建置、商品公開、社群連結三件事,建議直接來信 service@portaly.cc,標題註明「客服詢問」,並附上帳號網址、姓名、註冊 email、申請日期,客服會協助查詢。
Q:可以先用 Live Key 上線,之後再補驗證嗎?
不行。Live Key 只有驗證通過後才會開放申請,這個順序沒辦法跳過。
Q:Test 模式測試完,正式上線需要重新建立商品或方案嗎?
不用,只需要換 API Key,方案設定會沿用。
如果你還在 Test 模式階段,建議先看完整的串接步驟:Portaly Payment Agent 完整教學,把整套流程跑過一遍再送審會更順。準備好要申請正式收款了嗎?直接到 Portaly Payment 後台 建立 Live API Key。
Portaly 台灣團隊開發的創作者商務平台,提供 Link-in-Bio 個人頁面、數位商品銷售與品牌合作媒合工具,幫助創作者將內容影響力轉化為收入。
官方社群:Discord 官方群 | Instagram
用戶精選:創作者精選|KOL精選|品牌精選