price、方案和 Application。
準備工作
- 建立 Account Token。
- 從 Application 清單取得
application_id。 - 從 服務詳情的
packages中選擇與 Application 類型相符且可購買的package_id。
介面概覽
請求體
單一 Application 訂單使用application_id + package_id；批次訂單使用長度對應的 application_ids + package_ids。一般訂單在後續 /pay/ 請求中選擇付款方式。iOS 內購訂單建立時傳入 pay_way: "AppleIAP"，且只能選擇一個帶有 metadata.apple_product_id 和 metadata.apple_price 的 Usage 方案。Apple 內購使用獨立的美元預設價格，不疊加會員折扣、付款方式折扣或網站加價；其他地區的本幣扣款金額以 Apple 付款確認頁為準。
回應說明
成功回傳201 和新建立的 Order 物件。關鍵欄位包括 id、price、discount、state、application_id/application_ids、package_id/package_ids、expired_at 與時間欄位。新訂單通常是 Pending，接著呼叫支付訂單。
price是伺服器根據方案、網站加價和折扣計算後的應付金額；不要由用戶端自行計算。- Package 與 Application 服務或類型不相符時回傳
400。 - 免費且由系統管理的 Package 不能透過公開訂單介面自行領取。
- 為不屬於目前帳戶的 Application 建立訂單會被拒絕。