メインコンテンツへスキップ
チェックアウトセッションを使用してサブスクリプション注文を作成します。 Requires a session created via Create Checkout Session with productType: "subscription". 
POST /v1/actions/subscription-order/create-order
認証： API Key

​
リクエストボディ

フィールド型必須説明
checkoutSessionIdstringはいチェックアウトセッション ID（cs_ + UUID 形式）
billingDetailobjectはい税金計算用の請求詳細
buyerEmailstringいいえ消費者のメールアドレス
buyerIpstringいいえ消費者の IP アドレス（税金計算用）
successUrlstringいいえ成功時のリダイレクト URL のオーバーライド

​
請求詳細

フィールド型必須説明
countrystringはいISO 3166-1 alpha-2 国コード
isBusinessbooleanはいビジネス購入かどうか
statestring条件付きUS、CA の場合に必須
postcodestringいいえ郵便番号
businessNamestring条件付きisBusiness: true の場合に必須
taxIdstring条件付き税 ID（EU B2B 免税に必須）

​
リクエスト例

const { checkoutUrl } = await client.orders.createSubscriptionOrder({
  checkoutSessionId: "cs_550e8400-e29b-41d4-a716-446655440000",
  billingDetail: {
    country: "US",
    isBusiness: false,
    state: "CA",
    postcode: "94105",
  },
  buyerEmail: "customer@example.com",
});
// Redirect consumer to checkoutUrl

​
成功レスポンス (200)

{
  "data": {
    "checkoutUrl": "https://waffo.ai/store/my-store/checkout/token"
  }
}

​
レスポンスフィールド

フィールド型説明
checkoutUrlstring消費者が支払いを完了するためのリダイレクト URL
消費者を checkoutUrl にリダイレクトして支払いを完了させてください。チェックアウトページが支払い回収、税金計算、3D Secure 認証を処理します。セッションは商品バージョン、価格、通貨を固定します。

​
エラーレスポンス

ステータス説明
400必須フィールドの欠落 / 無効な請求詳細
401認証失敗
404チェックアウトセッションが見つからないか期限切れです
500内部サーバーエラー