Pending 訂單建立或刷新支付工作階段。支付動作會存取支付管道並可能變更訂單狀態,呼叫前必須確認訂單 ID、金額和支付方式。
介面概覽
匿名支付的邊界
匿名存取用於開啟複製的支付連結後登入狀態遺失的情境,不需要也不應攜帶長期 Account Token。匿名呼叫:- 僅允許伺服器端設定的託管跳轉支付方式;
- 固定使用桌面支付頁面;
- 無法領取零價訂單;
- 受 IP 和單一訂單限流;
- 回傳最小訂單投影,不包含帳戶、Application 或內部 metadata。
請求範例
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後再重試。

