Portaly Payment 使用者必看:正式金流收款前的檢查清單!

想用 Portaly Payment 開始收款,卻搞不清楚 Test 模式跟正式模式差在哪?這篇整理金流驗證流程、審核常見退件原因、到帳時間,一次看懂正式收款前該做的事,少走冤枉路。

如果你已經照著教學把 Portaly Payment 串進自己的產品,卻發現用戶付款一直沒反應,很可能是還卡在 Test 模式,或是金流驗證根本還沒過。這篇會用一張清單,把 Test/Live 模式差在哪、驗證流程要花多久、卡關時怎麼自救,一次講清楚。

金流驗證在審什麼?3 件事先確認再送審

金流驗證是人工審核,通常要 7-15 個工作天(不含例假日)。如果你是頂級方案會員,而且已經綁定信用卡,可以享有優先審核。

送審前,先對照這 3 項,能大幅降低被退件的機率:

  1. 商品或訂閱項目要「公開」上架,品名、定價、描述都要填完整,不能只是草稿狀態
  2. 附上自己產品的網站連結,審核人員會實際點進去確認你的產品是「已實際營運」的狀態
  3. 基本資料、身分證明、銀行帳戶資訊都要填寫正確、圖檔清晰

實務上最常見的退件原因,是系統顯示「頁面內容或商品項目不完整」,意思是審核團隊覺得你的頁面看起來還沒有「真的在營業」。把上面 3 點都補齊,重新送審就好,不需要整個流程重跑。

如何知道現在是真的可以收款還是在測試?看 API Key 開頭就知道!

很多人第一次卡關,其實不是程式碼寫錯,而是分不清楚自己現在是不是在「玩假的」。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%,長期用下來通常更划算。

FAQ

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。