post https://api.saisoncard.co.jp/app-service/sbps/register
SBPS(決済代行業者)に顧客IDとカード情報を渡して、顧客情報登録を依頼する。
TEJ002
RESPONSE
| 項目名(論理) | 項目名(物理) | 属性 | 最大桁数 [byte] | 必須 | 項目説明 | 備考 |
|---|---|---|---|---|---|---|
| エラーコード | error | 半角英数記 | 32 | ※1 | 発生したエラー内容を示すコード。 | ※エラーコードの値は、「API処理結果コード」を参照のこと。 |
| 処理結果コード | result_code | 半角数 | 3 | ※2 | 処理結果のコード値。 | ※処理結果コードの値は、「処理結果コード」を参照のこと。 |
| SBPSエラーコード | sbps_error | 半角英数記 | 8 | ※3 | SBPSのエラーコード。 | ※SBPS社の仕様書「エラーコードハンドリング」を確認ください。 |
| SBPS処理結果ステータス | sbps_result | 半角英数記 | 2 | ※2 | SBPSの処理結果。OK／NG | － |
| SBPSトランザクションID | sbps_transaction_id | 半角英数記 | 32 | ※3 | SBPS で管理するトランザクションを特定する ID。 | － |
| ※1 エラー時の場合のみ必須。正常処理時は返却されない項目。 ※2 リソースサーバ側から追加情報がある場合に設定する。 ※3 エラー時に、決済代行システムより追加情報がある場合に設定する。 |
API処理結果コード
| API処理結果コード | HTTP status code | 説明 |
|---|---|---|
| － | 200 | 正常終了 |
| invalid_request | 400 (Bad request) | APIにおける必須パラメータが欠如している場合。 パラメータに形式エラーがある場合。 |
| invalid_token | 400 (Bad request) | 該当カードにて該当サービス提供無しの場合。 会員ステータスエラー又は、カード解約している場合。 |
| invalid_token | 401 (Unauthorized) | アクセストークンが有効期限切れ、もしくはその他の理由で無効になっている場合。 連携されたアクセストークンが存在しない場合。 |
| insufficient_scope | 403 (Forbidden) | アクセストークンの持つ権限外のリソースへアクセスしようとした場合。 |
| insufficient_level | 403 (Forbidden) | 認証レベルが条件を満たしていない場合。 |
| maintenance | 503 (service Unavailable) | メンテナンス中の場合(セゾンコネクト) |
| maintenance_resource | 503 (service Unavailable) | メンテナンス中の場合(リソースサーバ) |
| temporarily_unavailable | 503 (service Unavailable) | 一時的な過負荷によってリクエストを扱うことができない。 |
| server_error | 500 (Internal Server Error) | 代行システムのエラー。 その他のエラー。 |
処理結果コード
| 処理結果 | パラメータ "error" の値 | パラメータ "result_code" の値 | 内容 |
|---|---|---|---|
| 正常終了 | － | 000 | 正常終了 |
| ステータスエラー | invalid_token | 103 | Netアンサーを退会している場合 カード解約している場合 |
| サービス対象外エラー | invalid_token | 104 | サービス対象外会員の場合 |
| 電文処理結果コード異常 | server_error | 107 | 電文の処理結果コードが異常の場合 |
| 電文送受信エラー | server_error | 108 | 電文の送受信時にエラー発生の場合 ※リソースサーバからの応答がなくタイムエラー、接続エラー等 |
| システムエラー | server_error | 999 | システムエラー |