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 API のレスポンス形式:codeが"0"は成功を示します- 失敗時、
codeはエラーコード文字列になります(例:"A0003"、"E0001") - レスポンスのフィールド名は
msgです(messageではありません)
エラーコードの分類
| プレフィックス | カテゴリ | 説明 |
|---|---|---|
| 0 | 成功 | — |
| A | 加盟店側エラー | パラメータ不正、権限不足など |
| B | ユーザー側エラー | 残高不足、決済タイムアウトなど |
| C | システムエラー | チャネル側の拒否、システムエラーなど |
| D | リスクコントロール拒否 | リスクコントロールにより取引がブロックされた |
| E | 不明なエラー | 重要: 決済が成功している可能性があります |
E0001 ステータス不明の処理
基本原則
- 失敗と判断しない: ネットワークタイムアウトは決済失敗を意味しません
- 注文を自動クローズしない: チャネル側で決済がすでに完了している可能性があります
- 新しい注文を作成しない: 元の
paymentRequestIdで照会してください
SDK のエラータイプ
| 言語 | ステータス不明エラー | クライアントエラー |
|---|---|---|
| Node.js | WaffoUnknownStatusError | WaffoError |
| Java | WaffoUnknownStatusException | WaffoException |
| Go | *core.WaffoUnknownStatusError | *core.WaffoError |
SDK のエラータイプは 2 種類のみです。
WaffoUnknownStatusError/Exception は決済が成功している可能性を示し、WaffoError/Exception はクライアント側のエラー(設定、署名など)を示します。SDK のエラーコード
| エラーコード | タイプ | 説明 |
|---|---|---|
| S0001 | UnknownStatus | ネットワークエラー(タイムアウト、接続失敗) |
| E0001 | UnknownStatus | サーバーが不明なステータスを返した |
| S0002 | Error | 公開鍵が無効 |
| S0003 | Error | 署名に失敗 |
| S0004 | Error | レスポンスの署名検証に失敗 |
| S0005 | Error | リクエストのシリアライズに失敗 |
| S0007 | Error | 秘密鍵が無効 |