post https://api.saisoncard.co.jp/app-service/payment/token
アクセストークンを受けて、カード情報を決済代行業者に連携し、取得した決済トークンをクライアントに返却する。
TEJ001
RESPONSE
| 項目名(論理) | 項目名(物理) | 属性 | 最大桁数 [byte] | 必須 | 項目説明 | 備考 |
|---|---|---|---|---|---|---|
| エラーコード | error | 半角英数記 | 32 | ※1 | 発生したエラー内容を示すコード | ※エラーコードの値は、「API処理結果コード 」を参照のこと。 |
| 処理結果コード | result_code | 半角数 | 3 | ※2 | 処理結果のコード値 | ※処理結果コードの値は、「処理結果コード 」を参照のこと。 |
| 決済システムエラーコード | payment_code | 半角英数記 | 可変 | ※3 | 決済代行システムのエラー内容を示す結果コード | 各決済代行システムの決済トークン発行エラーコードを参照のこと。 |
| 決済システムエラー詳細情報 | payment_info | 半角英数記 | 可変 | ※3 | 決済代行システムのエラー内容を示す詳細情報 URLエンコード(UTF-8)した値 | 各決済代行システムの決済トークン発行エラーメッセージを参照のこと。 |
| 決済トークン | token | 半角英数記 | 可変 | ※4 | 決済代行システムより発行された決済トークン | |
| 決済トークン有効期限 | expires_in | 半角数 | 14 | ※4 | 決済代行システムより発行された決済トークンの有効期限 | YYYYMMDDhhmmss 形式 |
| カード番号(マスク済み) | c_no | 半角数記 | 19 | ※4 | 決済トークンを発行したカード番号 | カード番号はハイフンなし・番号の一部を＊でマスク済み |
| ※1 エラー時の場合のみ必須。正常処理時は返却されない項目。 ※2 リソースサーバ側から追加情報がある場合に設定する。 ※3 エラー時に、決済代行システムより追加情報がある場合に設定する。 ※4 エラー時は返却されない項目。 |
API処理結果コード
| API処理結果コード | HTTP status code | 説明 |
|---|---|---|
| － | 200 | 正常終了 |
| invalid_request | 400 (Bad request) | 各APIにおける必須パラメータが欠如している場合。 パラメータに形式エラーがある場合。 |
| 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 | 503 (service Unavailable) | 代行システムのエラー。 その他のエラー。 |
処理結果コード
| 処理結果 | パラメータ "error" の値 | パラメータ "result_code" の値 | 内容 | 備考 |
|---|---|---|---|---|
| 正常終了 | － | 000 | 正常終了 | |
| 会員該当データ無し | invalid_token | 101 | 指定したユーザが存在しない場合 | |
| ステータスエラー | invalid_token | 103 | Netアンサーを退会している場合 カード解約している場合 | |
| サービス対象外エラー | invalid_token | 104 | サービス対象外会員の場合 | |
| 必須項目チェックエラー | invalid_request | 105 | リクエスト必須項目が取得できない場合 | ※1 パラメータ"error"の値は "server_error" を返却する |
| 決済システムキーエラー | invalid_request | 901 | 決済システムキー(GMO公開鍵ハッシュ値) がクライアント管理設定値と一致しない場合 | |
| 型チェックエラー | invalid_request | 106 | リクエスト項目の型に誤りがある場合 | ※1 パラメータ"error"の値は "server_error" を返却する |
| 電文処理結果コード異常 | server_error | 107 | 電文の処理結果コードが異常の場合 | |
| 電文送受信エラー | server_error | 108 | 電文の送受信時にエラー発生の場合 ※リソースサーバからの応答がなくタイムエラー、接続エラー等 | |
| システムエラー | server_error | 999 | システムエラー |