メインコンテンツへスキップ
チェックアウトセッションを使用して単発商品の注文を作成します。注文作成後、消費者を返された checkoutUrl にリダイレクトし、PSP ホスティングページで支払いを完了させます。 
POST /v1/actions/onetime-order/create-order
認証： API Key

​
リクエストボディ

フィールド型必須説明
checkoutSessionIdstringはいチェックアウトセッション ID（cs_ + UUID 形式）
billingDetailobjectはい注文の最終請求詳細
buyerEmailstringいいえ消費者のメールアドレス
buyerIpstringいいえ消費者の IP アドレス（税管轄の判定に使用）
successUrlstringいいえ支払い成功後のリダイレクト URL のオーバーライド

​
請求詳細オブジェクト

フィールド型必須説明
countrystringはいISO 3166-1 alpha-2 国コード
isBusinessbooleanはいビジネス購入かどうか
postcodestringいいえ郵便番号
statestring条件付きUS と CA の場合に必須
businessNamestring条件付きisBusiness が true の場合に必須
taxIdstringConditionalRequired for EU countries when isBusiness is true

​
リクエスト例

import { WaffoPancake } from "@waffo/pancake-ts";

const client = new WaffoPancake({
  merchantId: process.env.WAFFO_MERCHANT_ID!,
  privateKey: process.env.WAFFO_PRIVATE_KEY!,
});

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

// Redirect the consumer to complete payment
console.log(checkoutUrl);

​
成功レスポンス

{
  "data": {
    "checkoutUrl": "https://checkout.waffo.ai/my-store-abc123/payment/ORDER_TOKEN"
  }
}

​
レスポンスフィールド

フィールド型説明
checkoutUrlstringPSP ホスティング決済ページ URL。消費者をここにリダイレクトして支払いを完了させます。

​
エラー

ステータスメッセージ説明
400必須フィールドが欠落していますcheckoutSessionId or billingDetail is missing
400Invalid billingDetail請求詳細のバリデーションが失敗しました
404Session not found指定された ID に一致するチェックアウトセッションがありません
404Session expiredチェックアウトセッションの有効期限が切れています
このエンドポイントを呼び出した後、消費者を checkoutUrl にリダイレクトしてください。ホスティング決済ページが支払い回収、3D Secure 認証を処理し、完了時に successUrl にリダイレクトします。