post https://api.saisoncard.co.jp/app-service/wallet/instant_use_cancel
既存の確定した利用取引をキャンセルする。
(相殺の付与を行う)
TED035
RESPONSE
項目名(論理) | 項目名(物理) | 属性 | 最大桁数 [byte] | 必須 | 項目説明 | 備考 |
---|---|---|---|---|---|---|
認証処理エラーコード | error | 半角英数記 | 32 | ※1 | 発生したエラー内容を示すコード。 | ※認証処理エラーコードの値は、「認証処理エラーコード」を参照のこと。 |
処理結果コード | result_code | 半角数 | 3 | ※2 | AQFウォレット即時確定キャンセル処理結果のコード値 | ※処理結果コードの値は、「処理結果コード」を参照のこと。 |
レスポンス日時 | response_ts | 半角数 | 17 | ※3 | ポイント基盤からのレスポンス日時。 | 形式:YYYYMMDDhhmmss999 |
取引ID | deal_id | 半角英数 | 20 | ※3 | リクエストに対する取引IDとなります。※ ※ AQFウォレット即時確定キャンセルの場合も新規取引として新しく発行されます。 | 形式:DE+コンシューマ略称英字2文字+YYYYMMDD+通番8桁 例:DEXX2011052412345678 |
処理後の 支払用ウォレット残高 | wallet_balance | 半角数(数値) | 10 | ※3 | 処理後のウォレット残高 (100億以上の残高は一律"9999999999"とする) |
※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) | 一時的な過負荷によってリクエストを扱うことができない。 |
server_error | 500 (Internal Server Error) | その他のサーバサイドが原因のエラー。 |
処理結果コード
処理結果 | コード値 | 内容 | 内部サービスにおけるハンドリング (ユーザに提示する情報) |
---|---|---|---|
正常終了 | 000 | 処理継続 | |
リクエストID重複エラー | 201 | 過去に発行されたリクエストIDと重複している場合 | システムエラー |
権限エラー | 203 | クライアントや会員種別にAPI利用権限がない場合 | 登録された情報では取扱いできない旨表示 |
パラメータエラー | 204 | 各APIにおける必須パラメータが欠如している場合 パラメータに形式エラーがある場合 | システムエラー |
対象取引IDエラー | 502 | 取消、変更で指定された取引IDが存在しない場合 | システムエラー |
ウォレット数不整合エラー | 503 | 相殺のために指定された取引のウォレット数とリクエストされたキャンセルウォレット数が一致しない場合 | システムエラー |
取消済みエラー | 505 | AQFウォレット即時確定キャンセルで指定された取引が既に取消済みの場合 | システムエラー |
システムエラー | 999 | その他のエラー | システムエラー |