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

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.

標準的な決済は通常「Immediate Sale（即時販売）」であり、ユーザーが支払うと同時に資金が引き落とされます。Auth & Captureは決済プロセスを2つの明確なステップに分割します。

​
主な価値

​
ユースケース

AI画像生成、LLM推論、クラウド計算リースなど、コストが高く料金が変動するシナリオに最適です。
ステップタイミング内容
Authタスク開始前ユーザーが複雑な生成タスクを送信します。システムは最大料金10ドルと見積もり、その金額をフリーズし、ユーザーのカードが計算コストをカバーできることを確認します。
Captureタスク終了後タスクは実際に5,000トークン（4.50ドル相当）を消費しました。システムは4.50ドルのキャプチャを開始し、残り5.50ドルの与信枠を自動的に解放します。
利点: 「残高不足でタスクが中断」という悪い体験を回避しつつ、加盟店が高価なGPUリソースを無償提供することを防ぎます。

​
主な機能と操作

​
部分キャプチャ

事前オーソリされた注文に対して、元のフリーズ額より少ない金額でのキャプチャをサポートします。
シナリオ: AIタスクの見積もり10ドル、実際の消費4.50ドル。操作: 4.50ドルでCaptureリクエストを開始します。システムは4.50ドルを引き落とし、残り5.50ドルの枠を自動的に解放します。

​
オーソリのボイド

キャプチャを開始する前であれば、いつでも取引をキャンセルできます。
シナリオ: システム過負荷によりAIタスクが失敗、実際のコストは発生せず。操作: Void APIを呼び出します。特徴: コストゼロ（処理手数料なし）、即時解放（ユーザーの枠は数分以内に回復）—通常3〜7日かかる返金よりもはるかに優れています。

​
連携

​
API連携

決済注文作成時に capture_method: manual パラメータを設定することで、事前オーソリモードを有効化できます。デフォルトは automatic で即時販売となります。

​
Webhook通知

システムは以下のノードで通知を送信し、ビジネスステータスの同期を支援します。
イベント説明
payment_intent.authorized与信枠のフリーズに成功。AIタスクの開始や商品出荷を実行できます。
payment_intent.captured資金の引き落としに成功。資金は精算準備完了です。
payment_intent.canceled事前オーソリがボイドまたは失効。
APIドキュメントを見るでは、パラメータ例と連携ガイドを提供しています。

​
よくあるご質問

通常、Visa/Mastercardの事前オーソリは7日間有効です。AIサービスやEコマースの出荷には通常十分です。特殊業界（例: 長期レンタル）であれば、事前オーソリ期間を30日まで延長する申請を支援できます。
事前オーソリはユーザーの与信枠を「フリーズ」しているだけで、資金はユーザーの銀行口座内にあり、加盟店には送金されていません。Capture APIの呼び出しに成功した後にのみ、資金が精算を開始し、アカウント残高に入ります。
資金が実際には引き落とされていないため、「返金」は不要です。Void APIを呼び出すか、何もしない（自動失効を待つ）だけで、ユーザーの枠が回復します。これは返金プロセスより単純で、「課金された後に返金」というユーザーの混乱を回避できます。
現在は主に単一キャプチャをサポートしています。Captureを開始すると（部分金額であっても）、残りの事前オーソリ枠は自動的に解放されます。連続的なAIサービス（例: 分単位で課金されるチャットストリーム）を運営する場合、トークナイゼーション機能を使用してカードをバインドし、定期的（例: 1時間ごとまたは10ドル閾値到達時）に課金を開始することをお勧めします。
ヘルプが必要ですか？サポートに連絡する