跳轉到主要內容
為 Pending 訂單建立或刷新支付工作階段。支付動作會存取支付管道並可能變更訂單狀態,呼叫前必須確認訂單 ID、金額和支付方式。

介面概覽

匿名支付的邊界

匿名存取用於開啟複製的支付連結後登入狀態遺失的情境,不需要也不應攜帶長期 Account Token。匿名呼叫:
  • 僅允許伺服器端設定的託管跳轉支付方式;
  • 固定使用桌面支付頁面;
  • 無法領取零價訂單;
  • 受 IP 和單一訂單限流;
  • 回傳最小訂單投影,不包含帳戶、Application 或內部 metadata。
已驗證呼叫者必須是訂單擁有者或超級管理員。X402、獎勵兌換等需要使用者上下文的方式不能匿名呼叫。

請求範例

需要驗證的支付方式:
pay_way 使用訂單模型支援的真實值,例如 WechatPay、AliPay、Stripe、Card、Airwallex、X402、PayPal、AppleIAP、Reward、BankTransfer。並非每個值都對匿名請求或每個站點開放。

回應說明

成功回應是更新後的訂單物件,通常透過 pay_url 提供下一步入口;不同支付方式還可能在受控欄位中回傳用戶端繼續支付所需的資訊。匿名回應使用最小欄位白名單,已驗證擁有者取得完整詳情。 不要依賴 payment_url、qr_code_url 或 payment_method 等舊欄位名稱;目前 Order 契約使用 pay_url 和 pay_way。

銀行轉帳

已登入的個人帳號和企業帳號均可使用 BankTransfer,無需企業驗證。境內人民幣轉帳和國際美元轉帳均要求訂單金額至少為 300 美元;人民幣應付金額以付款時顯示的金額為準。 付款前可透過 GET /api/v1/orders/{order_id}/payment-options/ 查詢目前訂單可用的轉帳路線及金額門檻。銀行轉帳需要由訂單擁有者登入後發起,並受收款管道設定和方案適用範圍限制;匿名請求不可使用。

iOS 內購

已登入的訂單擁有者可傳入 pay_way: "AppleIAP"。此請求依所選方案的 metadata.apple_price 更新待付款訂單並清除折扣,不產生扣款、不發放點數,也不回傳支付連結。舊待付款訂單應先完成這一步,再發起 Apple 原生付款。僅支援一個已設定 Apple 商品和價格的 Usage 方案;不支援的方案或批次訂單回傳 400。 Apple 原生付款後透過 /api/v1/orders/{id}/apple-verify/ 提交 transaction_id 完成伺服器端驗證和點數發放。點數數量來自方案;金額使用 Apple 獨立美元預設價,不疊加會員折扣或站點加價,其他地區的本幣扣款金額以 Apple 確認頁為準。

錯誤與重試

  • 訂單不是 Pending:回傳 400;不要重複建立支付工作階段。
  • 未提供 pay_way:非零金額訂單回傳 400。
  • 匿名呼叫使用了不允許的方式或零價訂單:回傳 403,登入後由擁有者重試。
  • 已驗證但不是訂單擁有者:回傳 403。
  • 支付管道失敗:不要盲目重複提交;先查詢訂單詳情,確認仍是 Pending 後再重試。

相關介面