post https://api.saisoncard.co.jp/app-service/user/virtual_account/inquiry
振込先口座情報を照会する。
TEH001
RESPONSE
| 項目名_親(論理) | 項目名_子(論理) | 項目名(物理) | 属性 | 最大桁数 [byte] | 必須 | 項目説明 | 備考 |
|---|---|---|---|---|---|---|---|
| 認証処理エラーコード | － | error | 半角英数記 | 32 | ※1 | 発生したエラー内容を示すコード。 | ※認証処理エラーコードの値は、「認証処理エラーコード」を参照のこと。 |
| 処理結果コード | － | result_code | 半角数 | 3 | ※2 | バーチャル口座照会処理結果のコード値 | ※処理結果コードの値は、「処理結果コード」を参照のこと。 |
| バーチャル口座情報 | － | virtual_account_info | ※3 | 対象ユーザの振込先口座情報(最大数2) | 対象ユーザの振込先口座情報が存在しない場合、この項目が空リストになる。 | ||
| バーチャル口座情報 | 金融機関名称 | financial_name | 全角文字列 | 24 | ※3 | 振込先口座金融機関名称 | |
| バーチャル口座情報 | 支店名称 | branch_name | 全角文字列 | 24 | ※3 | 振込先口座支店名称 | |
| バーチャル口座情報 | 種目 | account_type | 全角文字列 | 10 | ※3 | 振込先口座種目 | |
| バーチャル口座情報 | 口座番号 | account_no | 半角数 | 7 | ※3 | 振込先口座番号 | |
| バーチャル口座情報 | 口座名義 | account_name | 全角文字列 | 60 | ※3 | 振込先口座名義 |
| ※1 エラー時の場合のみ必須。正常終了時は不要 ※2 エラー時に、追加情報がある場合に設定する（エラー時オプション項目） ※3 エラー時には、返却されません |
認証処理エラーコード
| パラメータ "error" の値 | HTTP status code | 説明 |
|---|---|---|
| ー | 200 | 正常終了 |
| invalid_request | 400 (Bad request) | トークンが空、または不正なフォーマットである場合。 指定された端末IDがアクセストークン発行時に指定されたものとは異なる場合。 |
| invalid_token | 401 (Unauthorized) | アクセストークンが有効期限切れ、もしくはその他の理由で無効になっている場合。 |
| insufficient_scope | 403 (Forbidden) | アクセストークンの持つ権限外のリソースへアクセスしようとした場合。 |
| maintenance | 503 (Service Unavailable) | メンテナンス中の場合(セゾンコネクト) |
| maintenance_resource | 503 (Service Unavailable) | メンテナンス中の場合(リソースサーバ) |
| temporarily_unavailable | 503 (Service Unavailable) | 一時的な過負荷によってリクエストを扱うことができない。 |
| insufficient_card | 503 (Service Unavailable) | 該当カードにて該当サービス提供無し。 |
| server_error | 500 (Internal Server Error) | その他のサーバサイドが原因のエラー。 |
処理結果コード
| 処理結果 | コード値 | 内容 | サービスにおけるハンドリング (ユーザに提示する情報) |
|---|---|---|---|
| 正常終了 | 000 | 処理継続 | |
| メンテナンス中(リソースサーバ) | 101 | リソースサーバメンテナンス中 | メンテナンス中 |
| サービス時間外 | 102 | 該当サービスがリソースサバにてサービス時間外 | サービス時間外 |
| 機能制御エラー | 103 | 該当カードにて該当サービス提供無し | 該当サービス提供無し |
| システムエラー | 999 | その他のエラー | システムエラー |