APIガイドライン
開発上の考慮事項
以下の変更は下位互換性があると見なされます：
新しいAPIリクエストを追加する。
既存のAPIリクエストまたはレスポンスに新しいオプションパラメータを追加する。
本文、クエリパラメータ、またはHTTPヘッダーとして追加してください。
新しい列挙値を追加する。
必須パラメータをオプションにする。
APIリクエストまたはレスポンスで受信した不明なフィールドや値を無視する。
エラー管理
レスポンスとエラータイプ
レスポンスはカテゴリに分類されます。同じカテゴリのすべてのレスポンスを同じ方法で処理してください。以下の表はカテゴリを列挙し、次の点を示します：
各カテゴリのエラータイプ。
イシュアバックエンドがこれらのエラーをどのように処理するか（再試行ポリシーを含む）。
K
OK、エラーではない
N/A
D
データエラー
関数リクエスタが送信したパラメータが、関数プロバイダがチェックするルールと一致しません。
S
システムエラー
システムの1つ以上の部分での一時的な障害によって発生する予期しないエラーです。 関数リクエスタはリクエストを再試行できます。 注意： HTTP 5xx エラーはシステムエラーと見なされます.
F
機能エラー
これは確定的なエラーです。処理を中止してください。再試行しないでください。 トークンはもはや使用できず、削除する必要があります。
エラー
以下の表は発生し得るエラーを列挙しています。
フローによって、エラーはレスポンス内で同期的に返される場合と、コールバックで非同期的に返される場合があります。
111
D
必須パラメータが欠落している
112
D
パラメータの形式が不正
113
D
不明なイシュア
114
D
不明なエンドユーザー
115
D
不明なプロダクト
116
D
不明なカード
117
D
不明なトークンストレージ
118
D
不明なリクエスト
119
D
不明なバーチャルカード
158
D
無効なパラメータ：カードの有効期限切れ
159
D
無効なパラメータ：カードが一時停止されている
160
D
無効なパラメータ：カードが取り消されるか削除されている
161
D
認証値が正しくありません。
カードセキュリティコード（CSC）が正しくない
無効な暗号ワンタイムパスワード（OTP）
163
D
モバイル決済でサポートされていないプロダクト
164
D
FPANプロビジョニング回数超過
166
D
無効なカード情報（FPAN、有効期限）またはカードが適格でない
167
D
カードは既に登録済み
168
D
エンドユーザーに紐付く電話番号がない
221
S
再試行後もデバイスまたはウォレットプロバイダにアクセスできない
222
S
デバイスまたはウォレットプロバイダがビジー状態
231
F
デバイスからの予期しないエラー
232
F
操作を実行するためのデバイスのメモリが不足している
321
S
トークンに対する操作が既に進行中である
322
S
操作の有効期限（タイムトゥリブ）が切れた
323
S
操作が部分的に完了した（通常、操作が複数のバーチャルカードを対象とし、そのうちの1つが失敗した場合）
421
S
OTPまたはPINがロックされている（リトライ上限超過）
422
S
OTPの有効期限が切れた
431
F
無効なパーソナライゼーションデータ
432
F
現在のトークン/カードの状態がこの操作を許可していない
501
D
ID&VメソッドIDが無効である
502
D
OTPを送信するための通信チャネルが利用できない
503
D
エンドユーザーが選択したID&Vメソッドは もはや 有効ではありません。 これは、登録中にチャネルデータ（例：電話番号）がID&Vプロセスに対して無効になった場合に発生することがあります。
510
F
ステップアップのカード所有者認証が拒否された（Visa CTFのみ）
520
F
ステップアップのカード所有者認証に失敗した（Visa CTFのみ）
521
S
プッシュサーバーエラー
531
F
プッシュトークンがもはや有効でない
911
F
操作に失敗した
920
F
OTP生成回数の上限を超えた
921
S
予期しないサーバーエラー
最終更新
役に立ちましたか？