跳轉到主要內容

支付成功頁怎麼做:結賬後應該顯示什麼,以及如何確認支付真的成功了

如何製作支付成功頁:買家結賬後應該看到什麼,在顯示"已支付"之前如何核對訂單,以及支付仍在處理中時該怎麼辦。

發佈於 約 3 分鐘閲讀

手繪插畫:一個瀏覽器顯示支付成功頁,上面有勾、訂單號和收據鏈接,一條虛線連回訂單狀態查詢,旁邊一個人正指着它
本文目錄
  1. 支付成功頁應該顯示什麼?
  2. 買家如何到達支付成功頁
  3. 在説"已支付"之前先核對訂單
  4. 支付成功頁的幾種狀態:已支付、處理中、失敗
  5. 支付成功頁要避免的錯誤
  6. 總結

支付成功頁是買家付款後到達的頁面:它確認這筆付款、説明買了什麼,並告訴買家接下來會發生什麼。它也是最常被做錯的頁面,因為很容易只要買家到了這個頁面就顯示"支付成功"。到達這個頁面什麼都證明不了——買家可以手動打開這個地址,跳轉發生時支付也可能還在處理中。

這篇文章説明一個好的支付成功頁應該顯示什麼、買家如何從 KukoPay 託管收銀台回到這裏、在説"已支付"之前如何核對訂單,以及結果還不確定時該怎麼處理。

支付成功頁應該顯示什麼?

  • 清楚的結果——"已收到付款",配一個視覺提示,而且只在你的服務器確認屬實後才顯示。
  • 買了什麼——商品或套餐、金額和幣種。
  • 參考號——你的訂單號,買家聯繫客服時要報的就是它。
  • 接下來會發生什麼——"你的套餐已生效"、"2 天內發貨"、"請查收郵件中的下載鏈接"。
  • 收據——一個鏈接,或者提示收據已發到郵箱,見 付款收據。
  • 如何聯繫你——遇到不對的地方可以找誰。

追加銷售和註冊引導可以放在這些之後,但不能代替它們。

買家如何到達支付成功頁

使用託管收銀台時,買家在 KukoPay 的頁面上付款,之後被帶回你在創建訂單時傳入的 return_url:

  1. 付款後,收銀台先顯示收據,約 5 秒後把買家帶回 return_url;買家也可以點擊立即返回,或留在當前頁。
  2. 重新打開一個已支付的收銀台鏈接,只會顯示收據,不會再次跳轉。

用佔位符把訂單寫進地址,這樣一個固定頁面就知道回來的是哪一筆訂單:

{
  "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 處理代碼裏。

在沙箱裏把它跑通

註冊商戶後即可申請測試密鑰,不需要等待資質審核。