waffo-integrate は Waffo 公式の AI 連携 Skill です。インタラクティブなウィザードを通じて、開発者の SDK 連携を自動的に完了させます。Claude Code や Cursor などの AI コーディングツールに対応しています。Documentation Index
Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
連携ロードマップ
waffo-integrate を利用する理由
| 指標 | Skill 利用時 | 手動連携 | 改善 |
|---|---|---|---|
| 連携成功率 | 100% | 75% | +25% |
| 平均所要時間 | 128 秒 | 192 秒 | -33% |
| トークン使用量 | 58.8k | 66.3k | -11% |
インストール
連携フロー
Skill を起動する
AI アシスタントにトリガーフレーズを入力します：
集成 Waffo 支付、integrate waffo、接入waffo、waffo sdk、または waffo payment。機能選択
必要な機能をインタラクティブに選択します（順番にプロンプト表示）：決済、返金、サブスクリプション、Webhook、加盟店設定照会、決済手段照会。スマート推奨：決済を選択すると返金の追加を提案。サブスクリプションを選択すると Webhook の追加を提案します。
フレームワーク選択（Webhook のみ）
| 言語 | 推奨フレームワーク | その他の選択肢 |
|---|---|---|
| Node.js | Express | NestJS、Fastify |
| Java | Spring Boot | — |
| Go | Gin | Echo、Fiber、Chi |
コードプレビューと生成
Skill はまず完全なコードをレビュー用に表示し、確認後に生成します：SDK 初期化、決済/返金/サブスクリプションサービス、Webhook 処理、テストファイル、
.env.example。13 項目の組み込み API ルール
Skill に組み込まれたルールが、よくあるミスを自動的に防止します：| # | ルール | 防止される問題 |
|---|---|---|
| 1 | リクエスト ID の最大長は 32 文字 | Waffo の冪等キー長制限を超える値 |
| 2 | サブスクリプションは orderCurrency ではなく currency を使用 | フィールド名の混同 |
| 3 | サブスクリプションは orderAmount ではなく amount を使用 | フィールド名の混同 |
| 4 | 各操作の必須フィールドチェック | payMethodType、goodsInfo などの欠落 |
| 5 | periodType は DAILY/WEEKLY/MONTHLY のみ | 無効な列挙値 YEARLY、MONTH |
| 6 | periodInterval は Number ではなく String | 型エラー |
| 7 | サブスクリプションは payMethodType が必須 | SDK エラー A0003 |
| 8 | productName は ONE_TIME_PAYMENT / SUBSCRIPTION のみ | 無効な製品タイプ |
| 9 | isSuccess() でレスポンスをチェック | エラー処理の欠落 |
| 10 | Webhook は署名検証 + レスポンス署名が必須 | セキュリティ脆弱性 |
| 11 | Java は WaffoConfig.builder() を使用 | SDK 初期化失敗 |
| 12 | タイムスタンプは SDK が自動注入 | 手動タイムスタンプ形式の誤り |
| 13 | merchantId は SDK が自動注入 | 重複設定 |
生成コードの特徴
- エラー処理：
WaffoUnknownStatusError（成功している可能性あり）とWaffoError（クライアントエラー）を区別 - セキュリティ：Webhook の署名検証 + レスポンス署名、環境変数による認証情報管理
- ベストプラクティス：冪等性のあるリクエスト ID、サービス層の分離、JSON 解析前の Webhook 登録
- テスト：サンドボックス連携テストスタブ、テスト用カード番号