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

Documentation Index

Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
まず接続パスを選ぶ

AI Integration

最速で導入既存コードベースがあり、Claude Code などのコーディングエージェントで設計、実装、検証まで進めたいチーム向けです。

API / SDK

最も高い制御性チェックアウトフローのカスタマイズ、サーバー側オーケストレーション、動的価格設定、細かな制御が必要なケース向けです。

Hosted Checkout

最もシンプルまず決済リンクで素早く収益化を確認し、その後で段階的に統合を深めたいチーム向けです。

​
どう選ぶか

いま重視したいことおすすめのパス理由
まず最初の利用可能版を早く出したいAI Integration既存コードベースをもとに、コーディングエージェントで短時間に統合を進めやすい
決済フローやサーバー側ロジックを細かく制御したいAPI / SDKカスタムチェックアウト、動的価格、権限制御、内部オーケストレーションに向く
深い実装の前に収益化フローを検証したいHosted Checkoutエンジニアリングコストを抑えて素早く公開できる
多くのチームは、最初に Hosted Checkout や AI Integration で立ち上げ、その後に API / SDK へ拡張していきます。

​
典型的なインテグレーション構成

Waffo Pancake の統合は、通常次の 4 つで構成されます。
  • 認証: サーバー側リクエストのための Merchant ID と API Key
  • 商品とチェックアウト: 単発商品またはサブスクリプション商品を作成し、購入導線を用意
  • Webhook: 決済、返金、サブスクリプションイベントの受信
  • 環境移行: テスト環境で検証し、その後本番へ公開
あなたのアプリケーション
    |
    +-- 認証 --> API / SDK リクエスト
    |
    +-- 商品 + チェックアウト --> 決済
    |
    +-- Webhook --> 注文・サブスクリプション同期
初日からすべてを実装する必要はありません。Hosted Checkout や AI Integration から始めて、後で API 利用を深めることもできます。

​
各パスで得られるもの

​
AI Integration

  • AI コーディングアシスタントに llms-full.txt と公式 skill コンテキストを読ませる
  • 技術スタックに合わせた統合コード、Webhook 処理、検証手順を生成できる
  • 既存コードベースがあり、実装時間を短縮したい場合に向く

​
API / SDK

  • 商品、チェックアウト、Webhook、状態同期をサーバー側で完全に制御できる
  • 動的価格、細かな権限管理、独自のバックエンド編成に向く
  • 長期的なカスタマイズや複雑な課金ロジックに最適

​
Hosted Checkout

  • ダッシュボードで生成したチェックアウトリンクや公開購入導線をそのまま使える
  • 深い開発投資の前に商用フローを検証したい場合に向く
  • 多くの場合、最初の導入段階に最適

​
推奨の導入順序

1

アカウント作成

Merchant Dashboard でサインアップし、最初のストアを作成します。
2

認証を準備

マーチャントダッシュボードで Merchant ID と API Key を用意します。
3

商品を作成

商品タイプ、価格、課金周期を定義し、ダッシュボードまたは API で商品を作成します。
4

チェックアウトを実装

API で Checkout Session を作成するか、ダッシュボードで生成したチェックアウトリンクを使います。
5

Webhook を処理

決済、返金、サブスクリプションイベント用の Webhook エンドポイントを設定します。
6

エンドツーエンドで検証

サンドボックス環境 とテストカードで全体フローを確認します。
7

本番公開

商品を公開し、本番環境へ切り替えます。

​
実装前に決めておくこと

コードを書く前に、次の点を明確にしておくと進めやすくなります。
  • 単発商品、サブスクリプション、または両方を扱うか
  • 超過利用、クレジット、見積もり金額などで動的価格が必要か
  • 支払い完了後に付与するアクセス権限やリソースは何か
  • どの Webhook イベントで業務状態を更新するか
  • どの機能を本番移行までテスト環境に留めるか
これらがまだ曖昧なら AI Integration から始めるのが効率的です。すでに整理できているなら API / SDK パスの方が適しています。

​
主要な導線

認証

Merchant ID、API Key、サーバー側認証を設定します。

サンドボックス環境

実課金なしでフルフローを検証します。

Webhooks

リアルタイムイベントを受け取り、注文とサブスクリプションを同期します。

SDKs

公式 SDK、フレームワークパターン、コード例を確認します。

AI Integration

AI コーディングアシスタントで設計、実装、検証を進めます。

Quickstart

最初の決済フローからエンドツーエンドの導線を素早く理解します。

​
開発者設定

開発者ページは、Waffo Pancake をアプリケーションと統合するためのツールを提供します。

​
APIキー

​
概要

APIキーは Waffo Pancake API へのサーバー間リクエストを認証します。

テストキー

  • test 環境用に作成
  • 開発に使用
  • 実際の課金なし
  • 本番データと分離

本番キー

  • prod 環境用に作成
  • 本番に使用
  • 実際の支払いを処理
  • 秘密鍵を安全に保管

​
キータイプ

キータイプユースケース説明
APIキーサーバーサイドのみ署名リクエスト、フルAPIアクセス

​
APIキー認証

API Key 認証は SDK が自動的に処理します。@waffo/pancake-ts をインストールし、Merchant ID と秘密鍵を提供するだけで、SDK がリクエストの署名を自動的に行います。
import { WaffoPancake } from "@waffo/pancake-ts";

const client = new WaffoPancake({
  merchantId: process.env.WAFFO_MERCHANT_ID!,
  privateKey: process.env.WAFFO_PRIVATE_KEY!,
});
クライアントサイドコード、バージョン管理、パブリックリポジトリで秘密鍵を公開しないでください。

​
APIキーの作成

1

開発者に移動

ダッシュボード → マーチャント → インテグレーション → APIキー
2

「APIキーを作成」をクリック

APIキージェネレーターが開きます。
3

キーペアを生成

「生成」をクリックしてキーペアを作成。
  • 公開鍵がサーバーに送信されます
  • 秘密鍵はあなたが保管します
4

キーに名前を付ける

説明的な名前を付ける（例：「本番サーバー」）
5

環境を選択

テストまたは本番環境を選択。
6

秘密鍵をダウンロード

重要： 秘密鍵をダウンロードして安全に保存。
秘密鍵は一度だけ表示されます。安全に保存してください — API認証に必要です。

​
キーの管理

アクション説明
表示キー名、作成日、環境を確認
削除キーを永久に削除

​
Webhooks

​
Webhooksとは？

Webhooksは、Waffo Pancakeでイベントが発生したときにサーバーに通知します。

​
利用可能なイベント

イベントトリガー
order.completed注文完了
subscription.activatedサブスクリプション有効化
subscription.payment_succeededサブスクリプション決済成功
subscription.updatedサブスクリプション更新
subscription.cancelingサブスクリプションのキャンセル予定
subscription.canceledサブスクリプション終了
subscription.uncanceledサブスクリプションのキャンセル取り消し
subscription.past_dueサブスクリプション決済期限超過
refund.succeeded返金処理成功
refund.failed返金処理失敗

​
Webhooksのセットアップ

1

エンドポイントを追加

WebhookのURL（HTTPSが必須）を入力。
2

イベントを選択

受信したいイベントを選択。
3

設定を保存

Webhookエンドポイントを保存。

​
Webhookペイロード例

{
  "event": "order.completed",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "orderId": "660e8400-e29b-41d4-a716-446655440001",
    "amount": 2900,
    "currency": "USD",
    "status": "completed",
    "createdAt": "2026-01-15T10:30:00.000Z"
  }
}
すべてのIDはUUID v4形式です。金額は最小通貨単位です。タイムスタンプはISO 8601 UTC形式です。

​
Webhookベストプラクティス

30秒以内に2xxステータスを返す。重い処理は非同期で行う。
イベントは複数回送信される可能性があります。イベントIDで重複排除。
失敗したWebhooksは最大5回、遅延を増やしながらリトライされます（5分、30分、2時間、24時間）。
ダッシュボードでWebhook配信ログを確認。

​
APIドキュメント

​
ベースURL

https://waffo-pancake-auth-service.vercel.app/v1

​
アーキテクチャ

Waffo Pancake はハイブリッド API を使用します：
  • REST（POST） — /v1/actions/... 経由のすべての書き込み操作
  • GraphQL — /v1/graphql 経由のすべての読み取り操作

​
認証例

SDK を使用した API キー認証（サーバー間通信）： 
import { WaffoPancake } from "@waffo/pancake-ts";

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

const { store } = await client.stores.create({ name: "My Store" });

​
一般的なエンドポイント

エンドポイントメソッド説明
/v1/actions/onetime-product/create-productPOST単発プロダクトを作成
/v1/actions/subscription-product/create-productPOSTサブスクリプションプロダクトを作成
/v1/actions/onetime-order/create-orderPOSTチェックアウトセッションを作成
/v1/actions/subscription-order/create-orderPOSTサブスクリプションチェックアウトを作成
/v1/graphqlPOSTデータをクエリ (GraphQL)

完全なAPIリファレンス

リクエスト/レスポンス例を含む完全なエンドポイントドキュメント。

​
セキュリティベストプラクティス

環境変数

秘密鍵はコードではなく環境変数に保存。

キーローテーション

特にチーム変更後は定期的にキーをローテーション。

キー分離

テストと本番で異なるAPIキーを使用。

安全な保管

プラットフォームのシークレット管理を使用して秘密鍵を保管。

​
テスト

​
テストモード

開発にはテストモードを使用：
  • すべてのエンドポイントが同じように動作
  • 実際の課金は処理されない
  • テストカード番号が利用可能
  • フルWebhookテスト

​
テストカード

カード番号動作
4576 7500 0000 0110成功（Visa）
2226 9000 0000 0110成功（Mastercard）
4576 7500 0000 0220拒否

​
ログとデバッグ

​
Webhookログ

Webhook配信を追跡：
  • イベントタイプ
  • 配信ステータス（成功/失敗）
  • エンドポイントからのHTTPレスポンス
  • リトライ回数とタイムスタンプ