支付成功頁怎麼做:結賬後應該顯示什麼,以及如何確認支付真的成功了
如何製作支付成功頁:買家結賬後應該看到什麼,在顯示"已支付"之前如何核對訂單,以及支付仍在處理中時該怎麼辦。
支付成功頁是買家付款後到達的頁面:它確認這筆付款、説明買了什麼,並告訴買家接下來會發生什麼。它也是最常被做錯的頁面,因為很容易只要買家到了這個頁面就顯示"支付成功"。到達這個頁面什麼都證明不了——買家可以手動打開這個地址,跳轉發生時支付也可能還在處理中。
這篇文章説明一個好的支付成功頁應該顯示什麼、買家如何從 KukoPay 託管收銀台回到這裏、在説"已支付"之前如何核對訂單,以及結果還不確定時該怎麼處理。
支付成功頁應該顯示什麼?
- 清楚的結果——"已收到付款",配一個視覺提示,而且只在你的服務器確認屬實後才顯示。
- 買了什麼——商品或套餐、金額和幣種。
- 參考號——你的訂單號,買家聯繫客服時要報的就是它。
- 接下來會發生什麼——"你的套餐已生效"、"2 天內發貨"、"請查收郵件中的下載鏈接"。
- 收據——一個鏈接,或者提示收據已發到郵箱,見 付款收據。
- 如何聯繫你——遇到不對的地方可以找誰。
追加銷售和註冊引導可以放在這些之後,但不能代替它們。
買家如何到達支付成功頁
使用託管收銀台時,買家在 KukoPay 的頁面上付款,之後被帶回你在創建訂單時傳入的 return_url:
- 付款後,收銀台先顯示收據,約 5 秒後把買家帶回
return_url;買家也可以點擊立即返回,或留在當前頁。 - 重新打開一個已支付的收銀台鏈接,只會顯示收據,不會再次跳轉。
用佔位符把訂單寫進地址,這樣一個固定頁面就知道回來的是哪一筆訂單:
{
"return_url": "https://shop.example.com/orders/{OUT_TRADE_NO}/complete"
}{OUT_TRADE_NO} 會被替換為你自己的訂單號,{TRADE_NO} 會被替換為 KukoPay 的交易號。見 託管支付頁面是什麼。
在説"已支付"之前先核對訂單
跳轉只服務於買家體驗,不是支付憑證。買家可能根本不回來,任何人也都可以手動輸入這個地址。所以頁面應該去問你自己的服務器訂單處於什麼狀態,而你的服務器應該從以下兩個地方之一得知:
- Webhook。 驗簽通過的
payment.succeeded才是你履約的依據,見 Webhook 驗簽怎麼做。 - 訂單查詢。 如果 Webhook 還沒到,你的服務器可以直接向 KukoPay 查詢:
curl "https://api.kukopay.com/v1/orders/ORD_20261116_0001" \
-H "X-Api-Key: $KUKOPAY_API_KEY"status 字段給出答案:paid、仍為 pending,或已關閉為 expired / failed。永遠不要從成功頁地址的查詢參數裏取結果,原因見 return_url 和 notify_url 的區別。
支付成功頁的幾種狀態:已支付、處理中、失敗
為每一種答案設計頁面,而不只是順利的那一種:
| 訂單狀態 | 頁面應該説什麼 |
|---|---|
paid | 已收到付款、買了什麼、接下來會發生什麼、收據鏈接 |
pending | "正在確認你的付款"——在短時間內刷新狀態(見下文) |
expired / failed | 付款沒有成功,並提供重試的入口 |
支付仍在處理中時
買家可能比 Webhook 先到,尤其是在錢包支付或 3D Secure 驗證之後。顯示"正在確認"的狀態,讓頁面每隔幾秒再問一次你的服務器,持續一兩分鐘。Webhook 一到,你的服務器就按自己的記錄回答,或者通過訂單查詢回答。如果之後仍在處理中,就告訴買家確認後會發郵件通知——並在 Webhook 處理代碼裏發出這封郵件。見 支付狀態詳解。
買家根本沒有回來時
有些買家會在跳轉倒計時期間關掉頁面。這沒關係:Webhook 照樣會到,訂單照樣履約,收據郵件也會確認這筆付款。永遠不要把履約邏輯放在成功頁上。
支付成功頁要避免的錯誤
- 頁面一加載就履約。 發貨、解鎖或發送授權碼,都應該在 Webhook 處理代碼裏、按事件
id只做一次,見 支付回調冪等處理。 - 相信地址參數,比如
?status=success。 - 對處理中的訂單顯示"已支付"。 它製造的正是這個頁面本該避免的客服工單。
- 丟了參考號。 如果買家只看到"謝謝!",出問題時他們什麼都報不出來。
- 死胡同。 鏈接到賬戶、訂單或下載頁——買家接下來要去的地方。
總結
- 支付成功頁要確認結果、買了什麼、參考號、接下來會發生什麼、收據以及如何求助;
- 使用 KukoPay 時,買家付款約 5 秒後回到你的
return_url,{OUT_TRADE_NO}/{TRADE_NO}會被替換為本訂單的值; - 到達頁面不是憑證:在你的服務器上,通過 Webhook 或訂單查詢核對訂單;
- 為
paid、pending和expired/failed分別設計頁面,履約只放在 Webhook 處理代碼裏。
在沙箱裏把它跑通
註冊商戶後即可申請測試密鑰,不需要等待資質審核。