メインコンテンツへスキップ

​
概要

Waffo Pancake でのすべての購入は、注文と関連する支払いレコードを作成します。注文は顧客の購入意思を表し、支払いは実際の金銭の動きを追跡します。

​
注文ステータス

注文には、商品タイプに応じて異なるステータスセットがあります。

​
単発注文

ステータス説明
pending注文が作成され、支払い待ち
completed支払いが成功し、注文が完了
canceled完了前に注文がキャンセルされた

​
サブスクリプション注文

ステータス説明
pendingサブスクリプションが作成され、初回支払い待ち
activeサブスクリプションが有効で、通常通り請求中
trialing顧客が無料トライアル期間中
past_due支払いが失敗し、再試行中
cancelingキャンセルリクエスト済み、現在の期間終了までアクティブ
canceledサブスクリプションがキャンセルされた（期間終了までアクセス継続）
expiredサブスクリプション期限切れ

​
支払いステータス

Pending

支払いが開始され、処理待ち。

Processing

支払いが処理中。

Succeeded

支払いが正常に完了。

Failed

処理中に支払いが失敗。

Refunded

全額返金が処理された。

Partially Refunded

一部返金が処理された。

​
支払い一覧

以下のカラムを持つテーブルですべての支払いを表示します：
カラム説明
日付取引タイムスタンプ
金額最小通貨単位での支払い金額
税額取引で徴収された税金
ステータス現在の支払いステータス
支払い方法card、bank_transfer、または wallet
顧客顧客のメールアドレス
通貨ISO 4217 通貨コード

​
フィルタリング

フィルターオプション
ステータスpending、processing、succeeded、failed、refunded、partially_refunded
日付範囲カスタムの開始日と終了日

​
支払い詳細

任意の支払いをクリックして、完全なレコードを表示できます。

​
取引情報

フィールド説明
Payment IDUUID v4 識別子
Order ID関連する注文
Store ID支払いを受けたストア
Amount総支払い金額（最小通貨単位）
CurrencyISO 4217 通貨コード
Status現在の支払いステータス
Created AtISO 8601 タイムスタンプ
Updated AtISO 8601 タイムスタンプ

​
金額詳細

フィールド説明
amount課金された合計金額
taxAmount金額のうち税額部分
settlementCurrency決済に使用される通貨
settlementAmount決済通貨での金額
refundedAmountこれまでに返金された合計金額

​
請求先情報

フィールド説明
country顧客の請求先国
state請求先の州または地域
postcode請求先郵便番号
isBusiness法人購入かどうか
businessName会社名（該当する場合）
taxIdTax ID（該当する場合）

​
支払い方法

支払いは使用された方法を記録します：
方法値
クレジット/デビットカードcard
銀行振込bank_transfer
デジタルウォレットwallet
支払い方法固有の追加情報は paymentMethodDetails フィールドで利用可能な場合があります。このフィールドの構造は支払い方法によって異なります。

​
対応している支払い方法

カード

クレジットカードおよびデビットカード決済。

銀行振込

銀行間の直接振込。

ウォレット

デジタルウォレット決済（Apple Pay、Google Pay など）。

​
返金

返金リクエストは、チケットベースの個別ワークフローで処理されます。購入者は支払いと理由を指定して返金チケットを送信し、マーチャントがリクエストを審査して承認または却下します。
返金プロセス、ステータス、ポリシーの詳細は返金ページをご覧ください。
主なルール：
  • 単発商品の返金は支払いから 7 日以内にリクエストする必要があります
  • サブスクリプションのキャンセルは現在の請求期間の終了時に有効になります
  • 返金チケットは独自のステータスを追跡します：pending、approved、rejected、processing、succeeded、failed

​
API リファレンス

​
注文の作成

注文は2ステップのチェックアウトセッションフローで作成します： ステップ1：チェックアウトセッションを作成（API Key または Store Slug 認証） 
curl -X POST https://waffo-pancake-auth-service.vercel.app/v1/actions/checkout/create-session \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "storeId": "store-uuid",
    "productId": "product-uuid",
    "productType": "onetime",
    "currency": "USD"
  }'
レスポンスは sessionId と checkoutUrl を返します。チェックアウトセッションの有効期限は7日間で、商品バージョンと価格がロックされます。 ステップ2：注文を作成（API Key 認証） 
curl -X POST https://waffo-pancake-auth-service.vercel.app/v1/actions/onetime-order/create-order \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY_TOKEN" \
  -d '{
    "checkoutSessionId": "session-uuid",
    "billingDetail": {
      "country": "US",
      "isBusiness": false,
      "state": "CA"
    }
  }'
両方のエンドポイントは checkoutUrl を返し、購入者はそのURLにリダイレクトされて支払いを完了します。

​
支払いの照会

GraphQL エンドポイントを使用して支払いレコードを照会できます： 
query {
  payments(storeId: "store-uuid", limit: 20) {
    id
    orderId
    amount
    currency
    status
    paymentMethod
    amountDetails {
      amount
      taxAmount
      settlementCurrency
      settlementAmount
      refundedAmount
    }
    billingDetail {
      country
      state
      postcode
      isBusiness
      businessName
      taxId
    }
    createdAt
  }
}
すべての金額は最小通貨単位で表されます。例えば、USD で 2900 は $29.00 を意味します。JPY のようなゼロ小数点通貨の場合、4500 は 4500 円を意味します。