概述
錢包介面允許已認證使用者讀取儲值設定、建立付款連結、兌換儲值碼、查詢儲值記錄以及管理自動儲值。讀取儲值設定
展示金額或付款方式前,始終先讀取目前設定:
這些值屬於部署和活動設定。建立付款連結前,應再次驗證所選金額。
建立付款連結
目前錢包流程接收整數美元金額以及以下付款方式:pay_link。獲得付款連結並不代表餘額已經入帳;付款服務商確認完成後,系統才會入帳。
不要把系統存取權杖放入跳轉 URL,也不要將其傳送給付款服務商。
兌換儲值碼
儲值記錄
items、page、page_size 和 total。付款完成後,應同時重新整理儲值記錄和帳號餘額:
quota_per_unit 換算。
讀取自動儲值狀態
bound:是否已綁定可重複扣款的付款方式card_last4:卡號末四位掩碼enabled:是否已啟用自動儲值threshold:觸發儲值的錢包美元餘額amount:每次觸發時儲值的美元金額stripe_ready:目前帳號是否可以設定自動儲值
綁定付款方式
尚未綁定付款方式時,啟動設定流程:setup_link。等待付款服務商回呼後,再次呼叫 GET /api/user/auto-recharge,確認 bound: true 後才能啟用自動儲值。
設定自動儲值
綁定完成後,一次性更新三個設定:threshold 不能為負數。目前控制台要求自動儲值的 amount 至少為 10 美元,但客戶端仍應遵守伺服器和付款服務商返回的最新限制。
如果只想關閉自動儲值而保留綁定的付款方式,請傳送相同請求內容,並將 enabled 設定為 false。
刪除付款綁定
推薦付款流程
- 讀取
/api/user/topup/info,驗證金額和付款方式。 - 只建立一次付款或綁定連結。
- 將使用者重新導向到傳回的連結。
- 將付款服務商的跳轉結果視為待確認狀態,而不是入帳證明。
- 輪詢
/api/user/topup/self、/api/user/self或/api/user/auto-recharge,直到出現預期狀態。 - 在應用層保證重試冪等,避免同一次使用者操作生成多個付款連結。