移動 App 如何收款:託管收銀台、返回鏈接與確認支付結果
移動 App 如何收款:在服務器上創建訂單、打開託管收銀台、用通用鏈接返回 App,並以 Webhook 確認支付結果。
要在移動 App 裏收款又不想自己做支付表單,可以從 App 打開託管收銀台,用戶付完款再帶他回來。App 永遠看不到銀行卡信息,Apple Pay、Google Pay 和錢包的用法和網頁上一樣,同一套後端同時服務你的網站和 App。需要用心的是它周圍的部分:訂單在哪裏創建、用戶如何回到 App,以及 App 如何得知支付真的成功了。
這篇文章説明如何用 KukoPay 的託管收銀台在移動 App 裏收款:整體流程、打開收銀台、用通用鏈接(Universal Link)或 App Link 返回 App、確認支付結果,以及要先查清的平台規則。
移動端支付流程
- App 請求你的後端,為用戶選中的商品開始結賬。
- 你的後端創建訂單,調用
POST /v1/orders——以你的訂單 id 作為out_trade_no,金額取自你自己的商品目錄——並返回checkout_url。 - App 打開
checkout_url,在 App 內的瀏覽器頁或系統瀏覽器中。 - 用戶在託管收銀台上付款。
- 收銀台把用戶帶回你的
return_url,由它打開 App。 - 你的後端從
payment.succeededWebhook 得知結果;App 向你的後端查詢訂單狀態並更新界面。
API 密鑰永遠不放進 App:安裝包可以被解開,裏面的密鑰等於公開。見 API 密鑰能放在前端嗎。
打開收銀台
- iOS: 用
SFSafariViewController或ASWebAuthenticationSession,既讓用戶留在 App 裏,又顯示完整的瀏覽器和地址欄。 - Android: 用 Custom Tabs 達到同樣效果。
- 儘量不要用裸的內嵌 WebView 付款:錢包和銀行驗證頁面往往需要真正的瀏覽器,用戶也看不到自己在哪個網站上輸入信息。
原樣打開返回的 checkout_url。它帶有只對這一筆訂單有效的短期令牌,所以不要記進日誌或傳給分析工具,見 託管支付頁面是什麼。
返回 App:用 https 鏈接,而不是自定義協議
付款後,收銀台先顯示收據,約 5 秒後(或用戶點擊返回時立即)把用戶帶到訂單的 return_url。KukoPay 只接受 http(s) 的返回地址,正式環境只接受公網 HTTPS——所以像 myapp://paid 這樣的自定義協議會被拒絕。請改用平台經過驗證的網頁鏈接:
- **iOS 通用鏈接(Universal Link)**和 Android App Link——你自己域名下的一個
https://地址,安裝了 App 時由系統用 App 打開,沒安裝時在瀏覽器中打開。
{
"return_url": "https://shop.example.com/app/orders/{OUT_TRADE_NO}/complete"
}{OUT_TRADE_NO} 會被替換為你的訂單號,App 就知道回來的是哪一筆訂單。如果沒有安裝 App,或鏈接沒能打開 App,同一個地址應該是一個説明結果的網頁,見 支付成功頁怎麼做。
在 App 裏確認支付結果
回到 App 不代表已經付款——用戶可能直接關掉瀏覽器,也可能在結果確定之前就回來了。所以:
- 在後端根據 Webhook 履約,而不是在 App 裏,見 支付回調冪等處理。
- App 回到前台時(無論是否經由返回鏈接),向你的後端查詢訂單狀態,並據此顯示已支付、確認中或未支付。你的後端根據自己的記錄回答,或調用
GET /v1/orders/{out_trade_no}。 - "確認中"時短暫輪詢,之後改為在 Webhook 到達時推送通知或發送 App 內消息。
先查清平台規則
應用商店對 App 內如何銷售在 App 內使用的數字商品和服務有自己的規則,這些規則可能要求某些商品、某些地區使用商店自己的應用內購買系統。實物商品和線下服務通常另有規定。在決定在 App 裏使用網頁收銀台之前,請查閲 Apple App Store 和 Google Play 針對你所售商品的現行政策。KukoPay 自己對可售商品的規則同樣適用,見 禁止經營的業務 和 數字產品支付網關。
測試移動端支付
- 後端使用沙箱密鑰:App 在沙箱和正式環境之間不需要任何改動。
- 用測試卡
4242 4242 4242 4242付款,錢包則通過其沙箱授權頁測試,見 支付測試卡號大全。 - 在真機上測試各種異常路徑:付款中途關掉瀏覽器、把 App 切到後台、卸載 App 後打開返回鏈接。
總結
- 在移動 App 裏收款,在後端創建訂單,從 App 打開託管的
checkout_url——App 裏既沒有密鑰也沒有卡表單; - 用 App 內瀏覽器頁(
SFSafariViewController、Custom Tabs)打開,而不是裸的 WebView; - 用
https://通用鏈接或 App Link 返回——不接受自定義協議,正式環境的返回地址必須是公網 HTTPS; - 在後端根據 Webhook 確認,App 返回時向後端查詢訂單狀態;
- 決定使用網頁收銀台之前,先查清應用商店對數字商品的規則。
在沙箱裏把它跑通
註冊商戶後即可申請測試密鑰,不需要等待資質審核。