> 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/xpay-enablement/ja/apirifarensu/tsp-api-v1/rirsu.md).

# リリース履歴

| リリース   | 日付                     | 変更内容                                                                                                                                                                                                                                                                        |
| ------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1.0    | トークンリクエスタ API の初回リリース。 |                                                                                                                                                                                                                                                                             |
| 1.0.1  | 23/01/2018             | <ul><li>API メソッド名を更新。</li><li>create token に deviceInfo を追加。</li><li>cipheredCardInfo に additionalCardInfos を追加。</li></ul>                                                                                                                                                  |
| 1.0.2  | 19/03/2018             | <ul><li>tokenStorageId の最大長を 64 に拡大。</li><li>additionalCardInfos の最大長を指定。</li><li>tokenPersoInfo#value の最大長を指定。</li><li>requestReplenisment および replenishmentDone パラメータの長さを指定。</li></ul>                                                                                    |
| 1.0.3  | 07/05/2018             | <ul><li>TSP がトークンを更新できるようにする新しいリクエストを追加。</li></ul>                                                                                                                                                                                                                          |
| 1.0.4  | 31/05/2018             | <ul><li>ヘルスチェックメソッドは、HTTP 200 ではなく HTTP 204 を返す。</li><li>cardRefId の長さを 64 に拡大。</li><li>createToken API に任意パラメータ「initialState」を追加。</li></ul>                                                                                                                                |
| 1.0.5  | 19/07/2018             | <ul><li>イシュアによって cardRefId が変更された場合に新しい cardRefId を提供するため、updateToken に新しい任意パラメータを追加。</li></ul>                                                                                                                                                                             |
| 1.0.6  | 14/08/2018             | <ul><li>API ごとに可能なエラーコードを追加。</li></ul>                                                                                                                                                                                                                                      |
| 1.0.7  | 25/09/2018             | <ul><li>updateTokenState API に新しい任意パラメータ reason を追加。</li></ul>                                                                                                                                                                                                              |
| 1.0.8  | 22/11/2018             | <ul><li>トークンの再パーソナライズ後に TSP へ通知する submitNewTokenDataStatus 操作を追加。</li></ul>                                                                                                                                                                                                 |
| 1.0.9  | 17/12/2018             | <ul><li>再試行可能なエラーに関する情報を追加。</li></ul>                                                                                                                                                                                                                                       |
| 1.0.10 | 17/12/2018             | <ul><li>submitTokenData および submitNewTokenData リクエストに tokenInfo を追加。</li><li>submitTokenData および submitNewTokenData リクエストのデータ要素値の最大長を拡大。</li></ul>                                                                                                                          |
| 1.1.0  | 07/05/2020             | <ul><li>TSH によってトリガーされた場合のトークン再パーソナライズフロー向けに repersoToken を追加。</li></ul>                                                                                                                                                                                                    |
| 1.1.1  | 26/06/2020             | <ul><li>Apple Pay の mCommerce transactionIdentifier に関する誤った説明を修正。</li><li>「Card Update」で説明されているフローのエラーを修正。リクエスト「updateToken」は TSP ではなく TSH によって送信される。</li></ul>                                                                                                             |
| 1.2.0  | 21/09/2020             | <ul><li><p>PKCS7 暗号化を管理する API を更新。暗号化に使用された RSA 公開鍵を表すキー識別子を以下に追加：</p><ul><li>createToken（cipheredCardInfo 用）</li><li>updateToken（newCipheredCardInfo 用）</li></ul></li><li>トークン取引通知 API の誤った説明を更新。transactionIdentifier は必須ではない（返金の場合）。</li></ul>                           |
| 1.2.1  | 08/01/2021             | <ul><li>TSH から TSP に送信される暗号化ペイロードの OAEP パディングをサポート。</li><li>追加 <a href="https://docs.payments.thalescloud.io/xpay-enablement/api-reference/guidelines">ガイドライン</a> セクション</li></ul>                                                                                           |
| 1.3.0  | 12/05/2021             | <ul><li>CCI 用途のために listTokens 関数を追加</li><li>PSD2 クリプトグラムスワップのユースケース向けに transmac 関数を追加</li></ul>                                                                                                                                                                             |
| 1.3.1  | 21/06/2021             | <ul><li>cardRefId の説明を更新</li></ul>                                                                                                                                                                                                                                          |
| 1.3.2  | 30/03/2023             | <p>Google Pay の更新：</p><ul><li>Google Pay データ準備セクションを追加</li><li>取引通知で使用する transactionIdentifier の説明を更新</li><li>Google Pay 向けの replenishment API を追加</li><li>listTokens API で返されるトークンオブジェクトに creationDate を追加</li></ul>                                                       |
| 1.3.3  | 25/09/2023             | <ul><li>createToken リクエストで送信され、listTokens レスポンスで返される「deviceInfo」オブジェクトに type を追加</li><li>listTokens API への入力として指定可能な cardRefId および cipheredTokenInfo を追加</li></ul>                                                                                                          |
| 1.3.4  | 24/11/2023             | <ul><li>どのウォレットタイプが取引を実行したかを示すため、トークン取引通知 API に新しい HTTP ヘッダーを追加</li><li>x-request-id ヘッダーの長さを 64 に拡大</li></ul>                                                                                                                                                              |
| 1.3.5  | 08/04/2024             | <ul><li>デバイスタイプ列挙型に新しい値「REALITY」を追加</li><li>replenishToken レスポンスのエラーを修正：paymentKeys は文字列の配列ではなく文字列</li><li>「HCE イシュア Wallets のパーソナライゼーション」セクションを追加</li></ul>                                                                                                                |
| 1.3.6  | 15/01/2015             | <ul><li>Google Pay Discover のパーソナライズデータ形式を追加</li></ul>                                                                                                                                                                                                                      |
| 1.3.7  | 05/06/2025             | <ul><li>トークン取引通知 API リクエストにパラメータ「linkedTransactionId」を追加。Google Pay ソリューションに適用可能。返金の場合に、通知を以前の購入取引に関連付けるために使用。</li></ul>                                                                                                                                                    |
| 1.3.8  | 17/03/2026             | <p>eCom 有効化の更新：</p><ul><li>createMerchant API を追加</li><li>createTransaction API</li><li>createToken API を更新</li></ul><p></p><p>xPay 有効化の更新：</p><ul><li>DPAN BIN 更新のサポートのため、submitNewTokenData リクエストに repersoedTokenId を、repersoToken リクエストに newTokenProductId を追加</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, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/xpay-enablement/ja/apirifarensu/tsp-api-v1/rirsu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.