Portaly
Portaly
登入免費註冊
Portaly Blog

繁體中文 | EN

文章總覽使用教學精選範例內容經營新手推薦訂閱

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

2026-08-24

    如果你已經照著教學把 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。

    作者介紹

    Portaly 台灣團隊開發的創作者商務平台,提供 Link-in-Bio 個人頁面、數位商品銷售與品牌合作媒合工具,幫助創作者將內容影響力轉化為收入。

    官方社群Discord 官方群 | Instagram
    用戶精選創作者精選KOL精選品牌精選

    打造你的傳送門

    Portaly 傳送門迄今超過 200,000 個創作者、品牌、商家使用。30 秒完成註冊,即可打造專屬自己的品牌首頁。

    立即註冊