> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transit-classic/ja/apirifarensu/dokyumento.md).

# ドキュメント履歴

| リリース   | 日付 (dd/mm/yyyy) | 変更点                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------ | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1.0.0  | 20/09/2018      | TES API の初版リリース                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.1  | 01/10/2018      | <ul><li><p>新しいエラーコードを追加</p><ul><li>provisionCard の拒否</li><li>アカウント不一致</li><li>無効なパーソ化データ</li><li>現在のカード状態では操作は許可されていません</li></ul></li><li>リクエスト/レスポンスヘッダにタイムスタンプのオプションパラメータを追加</li><li>カード取得方法に 'unknown' 値を追加</li><li>cardPersoData に keyIndex パラメータを追加</li><li>updateCardState (TES -> TSH) に新しいアクション PARK\_AND\_DELETE を追加</li><li>updateCardState (TSH -> TES) に新しいアクション BLACKLIST を追加</li><li>updateCardState (TSH -> TES) に新しいアクション BLACKLIST を追加</li><li>getCards で返される状態が CREATED、ACTIVE、SUSPENDED\_ISSUER、SUSPENDED\_WALLET、BLACKLISTED、DELETED に更新されました</li></ul>                                                                                                                                                                                                        |
| 1.0.2  | 22/10/2018      | <ul><li>新しい deviceType "UNKNOWN" を追加</li><li>新しいエラーコード "provisioning count exceeded" を追加</li><li>phoneNumerLastDigits のタイプミスを修正し、phoneNumberLastDigits に置換</li><li>provisionCard レスポンスにオプションパラメータ "displayCardNumber" を追加</li><li>updateCardState (TES -> TSH) から PARK\_AND\_DELETE アクションを削除</li><li>TES がユーザーへのメッセージ配信を要求できる新しい API sendMessage を追加</li><li>getCards から BLACKLISTED 状態を削除し、updateCardState (TSH -> TES) から BLACKLIST アクションを削除</li><li>カード口座が返金されたことを TES が TSH に通知できる新しい API refundCardAccount を追加</li><li>cardPersoData タイプに関する TES -> TSH の swagger の問題を修正</li><li>initiateCardSession の PARK\_CARD 操作を BLOCK\_AND\_READ\_CARD に置換</li><li>updateCardState (TSH -> TES) のパラメータ operation を newState に更新し、この呼び出しは変更を通知するもので要求するものではないことを反映するよう関連する値を更新</li></ul> |
| 1.0.3  | 05/11/2018      | <ul><li>orderId と purchaseId の長さを48から64に増加</li><li><p>paymentInstrument パラメータに新しいパラメータを追加（createCardAccound と topupCardAccount に適用）</p><ul><li>バージョン</li><li>ヘッダー</li><li>署名</li></ul></li><li>createCardAccount と topupCardAccount に新しい出力パラメータ "signature" を追加</li><li>responseHeader の statusCode は必須になりました</li><li>新しい API getRequestStatus と新しいエラーコード "unknow request" を追加</li><li>GDPR / RoI 準拠のための新しい LCM アクション "ERASE" を追加</li><li>新しい API getRequestStatus と新しいエラーコード "unknow request" を追加</li><li>provisionCard に customerData パラメータを追加</li></ul>                                                                                                                                                                                                                         |
| 1.0.4  | 10/12/2018      | <ul><li>古い API "getPurchaseStatus" と "updatePurchaseStatus" を削除</li><li>パークカード用の新しい Device GW API getParkCardCommands を追加</li><li><p>createCardAccount と topupCardAccount のための新しいエラーコードを追加</p><ul><li>419 PIN 必須</li><li>420 PIN 不正</li><li>421 PIN ロック</li></ul></li><li>updateCardState (TSH -> TES) のエラー、レスポンスから purchaseId を削除</li><li>createCardAccount リクエストに productId を追加</li><li>provisionCard に cardLastDigits を追加</li><li>トランジット通知 API のプレフィックス URL を修正（xxx/v1.0 から xxx/1/0 へ）</li></ul>                                                                                                                                                                                                                                                                                |
| 1.0.5  | 07/01/2019      | <ul><li>getRequestStatus API レスポンスから RECEIVED ステータスを削除</li><li>無効なカード情報に対する新しいエラーコード 166 を追加</li><li>paymentInstrument の signature と paymentData は最大8192文字に制限</li><li>createCardAccount と topupCardAccount の paymentInstrument に RSA アルゴリズムで使用される wrappedKey パラメータを追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.6  | 01/02/2019      | <ul><li>通勤プラン管理のための新しいメソッド updateCardMetadata を追加</li><li>getReaderModeCommands に cardContents オブジェクトパラメータを追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 1.0.7  | 08/02/2019      | <ul><li>通勤プランのローカライズされたタイトルをサポートを追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.0.8  | 21/02/2019      | <ul><li>initiateCardSession と getCardCommands 間で operation の可能な値を整合</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.0.9  | 18/03/2019      | <ul><li>新しい状態 "UNLINKED" が updateCardState (TSH -> TES) で送信可能に</li><li>UNLINKED カード状態を管理するために getCards API を更新し、カード口座状態を返すようになりました</li><li>provisionCard レスポンスに新しいオプションパラメータ "cardholderName" を追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| 1.0.10 | 02/04/2019      | <ul><li><p>デバイスゲートウェイ API に新しいエラーコードを追加</p><ul><li>172 無効なカード、サポートされていないシステムコード</li><li>173 無効なカード、サポートされていないサービス</li><li>177 無効なカード、無効なエリアデータ</li><li>178 無効なカード、カードの状態が in-station</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 1.0.11 | 16/04/2019      | <ul><li><p>getCards レスポンスを更新</p><ul><li>cardAccountId を削除</li><li>walletAccountId、cardAccountState、walletCardAccountId がトップレベルになりました</li></ul></li><li>カード所有者名のローカリゼーション管理のために provisionCard レスポンスを更新</li><li><p>getParkCardCommands と getReaderModeCommands を更新</p><ul><li>レスポンスに新しいパラメータ "cardData" を追加</li><li>cardData は "balanceAmount" を含む</li></ul></li><li>TES -> TSH API にエラーコード 221 を追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                        |
| 1.0.12 | 24/04/2019      | <ul><li>新しいクライアント TSM 仕様 2.2 を考慮するためにデバイスゲートウェイにエラーコードを追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| 1.0.13 | 17/05/2019      | <ul><li>operation 値 "RENEW\_CARD" を "UPDATE\_PLAN" に改名</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 1.0.14 | 27/05/2019      | <ul><li><p>notifyOperationResult の更新</p><ul><li>cardId がオプションになりました</li><li>オプションパラメータ purchaseId を追加</li><li>オプションパラメータ cardAccountId を追加</li><li>isProvisioning パラメータを追加</li></ul></li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 1.0.15 | 06/06/2019      | <ul><li>walletAccountId は createCardAccount から削除（provisionCard でのみ送信）</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.16 | 23/07/2019      | <ul><li>デバイスゲートウェイメソッドから retryCount を削除</li><li>エラー 922 の削除</li><li>TSH -> TES メソッドに対するエラー 432 を追加</li><li>カードパーソデータ長を500から8192に増加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| 1.0.17 | 11/12/2019      | <ul><li>checkCardAccount で提供される walletProviderId の列挙制約を削除</li><li>device-gateway と transit-tsh-to-tes に新しい HTTP ヘッダ x-actor-id を追加。このヘッダはリクエストを開始するウォレットプロバイダを示します。その値は checkCardAccount で定義された walletProviderId に対応します</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| 1.0.18 | 26/10/2020      | <ul><li>notifyOperationResult に TES に追加情報を渡すための新しいオプションパラメータ "resultData" を追加</li><li>ウォレットから開始されたチャージに関連する場合、getCardCommands 内で TSH が TES に渡す新しいパラメータ "purchaseId" を追加</li><li>provisionCard レスポンスに新しいパラメータ "cardData" を追加</li><li>createCardAccount と topupCardAccount リクエストに新しいオプションパラメータ "opaqueServiceProviderData" を追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| 1.0.19 | 30/11/2021      | <ul><li>新しい関数 getCardAccountsMetadata を追加</li><li>新しい関数 getCardActions を追加</li><li>checkCardAccount レスポンスおよび updateCardMetadata リクエストに新しいオプションパラメータ 'cardArtManifest' を追加</li><li>新しい関数 getAsset を追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| 1.0.20 | 28/02/2024      | <ul><li>getCardActions レスポンス内の cardActions オブジェクト内に定義済みの静的プロビジョニング値を置換できるように、オブジェクト配列の新しいパラメータ "title" を追加</li><li>追加 <a href="https://thales-dis-dbp.stoplight.io/docs/digital-transit/33e2dd0faee3a-calypso-toc">カードデータ準備における Calypso の真実</a> セクション</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 1.0.21 | 14/1/2024       | <ul><li>checkCardAccount レスポンスに新しいパラメータ 'mobileApplicationInfo' を追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 1.0.22 | 11/12/2025      | <ul><li>provisionCard レスポンスに新しいオプションパラメータ 'cardArtManifest' を追加</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/transit-classic/ja/apirifarensu/dokyumento.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.